Search Crypto Fundraising & Token Sale Events (by Project Name)

{
  "type": "object",
  "required": [
    "sort_by"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "Optional project name, alias, symbol, title, or summary search query. When provided, the trimmed query must contain 2-100 Unicode characters. Example: elliptic."
    },
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "Inclusive event-time upper bound. Accepts Unix seconds, YYYY-MM-DD, or RFC3339; date-only values end at 23:59:59 UTC. Defaults to the current time. Example: 2026-07-10."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Inclusive event-time lower bound. Accepts Unix seconds, YYYY-MM-DD, or RFC3339; date-only values start at 00:00:00 UTC. Example: 2026-07-01."
    },
    "lang": {
      "enum": [
        "en",
        "zh",
        "ja",
        "kr"
      ],
      "type": "string",
      "default": "en",
      "description": "Display and search language. Missing translated fields fall back to English. Example: en. Defaults to \"en\"."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Example: 20. Defaults to 20."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort order. Relevance only supports desc. Example: desc. Defaults to \"desc\"."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset. The offset plus limit cannot exceed 10000. Example: 0. Defaults to 0."
    },
    "source": {
      "enum": [
        "social",
        "news"
      ],
      "type": "string",
      "description": "Filter by public source type: social or news. Example: social."
    },
    "sort_by": {
      "enum": [
        "recency",
        "relevance",
        "importance"
      ],
      "type": "string",
      "description": "Sort by recency, query relevance, or importance. Relevance requires q. Example: recency."
    },
    "min_importance": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Minimum importance score from 1 to 5. Omit to include unscored events. Example: 3."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Opaque per-event identifier (observed as a UUID)."
          },
          "title": {
            "type": "string",
            "description": "Headline for the event."
          },
          "source": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "Observed only as 'social' across both real captures; the input schema also documents 'news' as a possible value, not yet observed in a fixture."
              }
            },
            "additionalProperties": true
          },
          "summary": {
            "type": "string",
            "description": "One to two sentence summary of the event."
          },
          "event_at": {
            "type": "number",
            "description": "Unix seconds; when the underlying event itself occurred."
          },
          "importance": {
            "type": "number",
            "description": "Importance score, observed 1-5 across real fixture values."
          },
          "published_at": {
            "type": "number",
            "description": "Unix seconds; when the source post/article was published."
          },
          "source_count": {
            "type": "number",
            "description": "Number of distinct sources reporting this event, observed ranging from 1 to 239."
          }
        },
        "additionalProperties": true
      },
      "description": "Matching events, most relevant/recent first depending on sort_by. Empty when the query genuinely matches nothing (observed on nonsense-empty.json)."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "Echoes the requested page size."
        },
        "total": {
          "type": "number",
          "description": "Total matching events across all pages."
        },
        "cached": {
          "type": "boolean"
        },
        "offset": {
          "type": "number",
          "description": "Echoes the requested pagination offset."
        }
      },
      "additionalProperties": true
    }
  },
  "description": "Search results: matching fundraising/token-sale events plus pagination metadata.",
  "additionalProperties": true
}