---
title: "List buy orders"
method: GET
path: "/api/public/v1/orders"
tags: ["Buy Orders"]
---

# List buy orders

`GET /api/public/v1/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.

## Query parameters

- `cursor` string — 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.
- `limit` integer, 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 `200`

A page of buy orders.

- BuyOrderListResponse
  - `data` object[], required
    - `slug` string, required
    - `status` 'active' | 'execution_in_progress' | 'execution_success' | 'execution_failed' | 'deleted' | 'monitoring_started' | 'monitoring_expired', required
    - `maxSpendUsdc` string, required — Per-buy USDC spend cap.
    - `maxFdvUsdc` string, nullable, required — FDV cap in USDC, or null when uncapped.
    - `expiresInMs` integer, required — How long, in milliseconds, the buy order stays active.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, nullable, required
  - `meta` object, required
    - `limit` integer, required
    - `nextCursor` string, nullable, required — Opaque cursor for the next page, or null on the last page. Pass it back as the `cursor` query parameter.

## Other responses

- `400` — Invalid pagination parameters, an unknown cursor, or an unknown status filter.
- `401` — Missing, invalid, or revoked API key.
- `429` — Rate limit exceeded. Wait `Retry-After` seconds before retrying.
- `500` — An unexpected server-side error occurred.

---

[API](https://skmtc.dev/thefirm/apis/autoboy-public-api.md) · [All operations](https://skmtc.dev/thefirm/apis/autoboy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thefirm/autoboy-public-api/revisions/6cba23209c3a/schema)