API reference · Events

List events

GEThttps://fomodata.dev/v1/events

Scopes:events:readRate class:standard

Historical events, newest first, within your plan's history window.

Event types: thesis.created, profile.updated, token.activity, token.thesis_velocity. The same Event object is delivered over REST, SSE, WebSocket streams and webhooks; id is stable for deduplication. source is fomo for upstream events, fomodata for events FomoData derives from them (activity, velocity) and sandbox for labelled test data.

Example request

curl 'https://fomodata.dev/v1/events?types=thesis.created' \
  -H "Authorization: Bearer $FOMODATA_API_KEY"

Try it in the playground

Parameters

Query parameters

typesstring: Comma-separated event types to include.
limitinteger: Page size, 1–100 (default 25).
cursorstring: Opaque next_cursor from the previous page.

Response

200 A page of events

application/jsonEventList

objectenumrequired"list"
dataarray<Event>required+ 8 child attributes
- objectenumrequired"event"
- idstringrequired
- typeenumrequired"thesis.created""profile.updated""token.activity""token.thesis_velocity"
- created_atstring (date-time)required
- livemodebooleanrequired
- sourceenumrequiredfomodata = derived by FomoData from authorized upstream events (activity, velocity)."fomo""sandbox""fomodata"
- testbooleantrue for dashboard/API-generated test events (never real Fomo activity).
- dataThesisCreatedData | ProfileUpdatedData | TokenActivityData | ThesisVelocityDatarequired
next_cursorstring | nullrequired
has_morebooleanrequired

200 · exampleJSON

{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "evt_2Nf8QpLx0VbT6mRz4kWc1S",
      "type": "thesis.created",
      "created_at": "2026-10-07T10:04:12.000Z",
      "livemode": true,
      "source": "fomo",
      "test": true,
      "data": {
        "thesis_id": "string",
        "profile": {
          "id": "fp_4KZq8mXw2T0aN6rB1cYd9E",
          "handle": "@milo",
          "display_name": "Milo",
          "avatar_url": "https://example.com"
        },
        "token": {
          "id": "tk_9bF2kLmQ0sVx7RtY3nHc1A",
          "symbol": "$RUN",
          "name": "Run",
          "chain": "robinhood",
          "address": "0x5a4d1f3c0f6e2b8d9a7c4e1f0b3d6a9c2e5f8a1b"
        },
        "text": "string",
        "created_at": "2026-10-07T10:04:12.000Z",
        "public_url": "https://example.com"
      }
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Errors

Status	When
`400`	Bad request
`401`	Missing, invalid, revoked or expired API key
`403`	Insufficient scope, live access not approved, or history limit
`422`	Validation failed
`429`	Rate limit or quota exceeded

All errors use the standard envelope. See error codes for every code value.

← All endpoints openapi.json