Skip to main content
GET /api/v1/events returns a paginated list of public trading events.

​
Supported filters

  • traderIds
  • assetIds
  • directions
  • eventTypes
  • startTime
  • endTime
  • limit
  • cursor

​
Example: filter by asset

curl -s 'https://partners.centaur.io/api/v1/events?assetIds=34&limit=10' \
  -H 'x-api-key: <partner-api-key>'

​
Example: time-bounded query

curl -s 'https://partners.centaur.io/api/v1/events?startTime=2026-03-01T00:00:00.000Z&endTime=2026-03-31T23:59:59.999Z&limit=25' \
  -H 'x-api-key: <partner-api-key>'

​
Default time range

  • If startTime and endTime are both omitted, the API may apply a bounded default window.
  • If an explicit startTime is earlier than the accessible window, the API can clamp it forward.
  • The actual bounds used for the response are returned in data.meta.appliedTimeRange.

​
Pagination rules

  • Pass cursor from meta.nextCursor to advance to the next page.
  • Pagination is forward-only.
  • Cursors remain usable if matching events disappear between requests because of deletion or eligibility changes.
  • Later pages may omit rows that disappeared after an earlier fetch.
  • Pagination reflects the current eligible set and is not a frozen snapshot.
  • limit accepts up to 100.
Last modified on April 14, 2026