Project Event Search

GET /gateway/v1/search/events

Project Event Search

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/search/events

200

{
  "data": [
    {
      "title": "<string>",
      "type": "<string>",
      "date": "<string>",
      "description": "<string>",
      "logo_url": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponseProjectEventItem.json"
}

Query Parameters

id · string

Surf project UUID. PREFERRED — always use this when available from a previous response (e.g. project_id from /fund/portfolio or id from /search/project). Takes priority over q.

Example:

"25c6612a-395c-4974-94eb-3b5f9f4b2ed7"

q · string

Fuzzy entity name search. Only use when 'id' is not available. May return unexpected results for ambiguous names.

Example:

"ethereum"

type · enum<string>

Filter by event type. Can be launch, upgrade, partnership, news, airdrop, listing, or twitter.

Available options: launch, upgrade, partnership, news, airdrop, listing, twitter

Example:

"launch"

limit · integer<int64> · default: 20

Results per page

Required range: 1 <= x <= 100

Example:

20

offset · integer<int64> · default: 0

Pagination offset

Required range: x >= 0

Example:

0

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseProjectEventItem.json"