THthefirm
Buy Orders

List buy orders

Returns a cursor-paginated page of the API key owner's buy orders, ordered by spend amount. Excludes deleted buy orders unless ?status=deleted is passed.

get/api/public/v1/orders

Request

Query parameters

cursorstring

Opaque cursor marking where the previous page ended. Omit it to fetch the first page; pass the meta.nextCursor from a response verbatim to fetch the next. A null meta.nextCursor means there are no more pages. Treat the value as opaque — its format varies per endpoint.

limitinteger nullable

Maximum number of items per page. Defaults to 20; values are clamped to 1–100.

status'active' | 'execution_in_progress' | 'execution_success' | 'execution_failed' | 'deleted' | 'monitoring_started' | 'monitoring_expired'

Response

A page of buy orders.

Example response

{
  "data": [
    {
      "slug": "thefirm",
      "status": "active",
      "maxSpendUsdc": "50",
      "maxFdvUsdc": "5000000",
      "expiresInMs": 86400000,
      "createdAt": "2026-01-15T09:30:00.000Z"
    }
  ],
  "meta": {
    "limit": 20,
    "nextCursor": "eyJtYXhTcGVuZFVzZGNBdG9taWMiOiIyNTAwMDAwMCIsImlkIjoiYjJjM2Q0ZTUifQ"
  }
}

Changes

No recorded changes to this operation across all 6 revisions of this API.