List Events - DexBuilder Docs

GET

api

event_contracts

events

List Events

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/event_contracts/events

{
  "items": [
    {
      "active": true,
      "category": "<string>",
      "closed": true,
      "closed_time": 123,
      "end_date": 123,
      "event_id": "<string>",
      "icon": "<string>",
      "image": "<string>",
      "slug": "<string>",
      "start_date": 123,
      "start_time": 123,
      "tags": [
        {
          "label": {},
          "slug": "<string>",
          "tag_id": "<string>"
        }
      ],
      "title": {},
      "volume": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

Returns a cursor-paginated list of events. Base URL: https://api.dexbuilder.com Authentication: This is a public market-data endpoint and does not require authentication.

Request

curl -G "https://api.dexbuilder.com/api/v4/event_contracts/events"

Use limit and cursor for pagination. Optional filters include event ID, slug, tag, active, and closed state. The OpenAPI panel below is the source of truth for required parameters, types, enum values, and request-body fields. Timestamps are Unix timestamps unless the field description states otherwise.

Response

The response contains items and next_cursor. Each event includes identifiers, title/description, lifecycle flags, dates, tags, volume, and (where available) a market summary. A successful response uses HTTP 200. Invalid parameters or request bodies return HTTP 400. Private endpoints can return HTTP 401 when authentication fails, and temporary upstream failures can return HTTP 503. The error response contains a machine-readable label and message. For order, position, claim, transfer, and account operations, treat the response as the current server result and query the resource again when the operation is asynchronous.

Query Parameters

limit

integer

cursor

string

sort

string

ascending

boolean

event_id

string

slug

string

tag_slug

string

active

boolean

closed

boolean

start_date_min

integer

Unix timestamp in milliseconds.

Required range: x >= 0

start_date_max

integer

Unix timestamp in milliseconds.

Required range: x >= 0

end_date_min

integer

Unix timestamp in milliseconds.

Required range: x >= 0

end_date_max

integer

Unix timestamp in milliseconds.

Required range: x >= 0

tag_id

string[]

Repeatable Tag ID filter.

exclude_tag_id

string[]

Repeatable excluded Tag ID filter.

Response

Request succeeded

Response object.

items

object[]

Show child attributes

next_cursor

string | null

Cursor for the next page; null means there are no more results.

List Events

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/event_contracts/events

{
  "items": [
    {
      "active": true,
      "category": "<string>",
      "closed": true,
      "closed_time": 123,
      "end_date": 123,
      "event_id": "<string>",
      "icon": "<string>",
      "image": "<string>",
      "slug": "<string>",
      "start_date": 123,
      "start_time": 123,
      "tags": [
        {
          "label": {},
          "slug": "<string>",
          "tag_id": "<string>"
        }
      ],
      "title": {},
      "volume": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

​Request

​Response

Query Parameters

Response

Request

Response