API reference · Events

Retrieve an event

GEThttps://fomodata.dev/v1/events/{id}

Scopes:events:readRate class:standard

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/evt_2Nf8QpLx0VbT6mRz4kWc1S' \
  -H "Authorization: Bearer $FOMODATA_API_KEY"

Try it in the playground

Parameters

Path parameters

idstringrequired: Event id (evt_…).

Response

200 The event

application/jsonEvent

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

200 · exampleJSON

{
  "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"
  }
}

Errors

Status	When
`401`	Missing, invalid, revoked or expired API key
`403`	Insufficient scope, live access not approved, or history limit
`404`	Not found (or feature disabled)
`429`	Rate limit or quota exceeded

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

← All endpoints openapi.json