> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fundingperpetuals.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Walk recent order history with a bounded opaque cursor.

`GET /v1/orders` returns newest orders first. Set `limit` from 1 to 100; the
default is 50.

When `has_more` is true, send `next_cursor` as the next request's `cursor`
parameter. Treat the cursor as opaque and URL-encode it:

```bash theme={null}
curl --get "https://developers.fundingperpetuals.com/v1/orders" \
  -H "Authorization: Bearer $FP_API_KEY" \
  --data-urlencode "account_id=ACCOUNT_ID" \
  --data-urlencode "limit=50" \
  --data-urlencode "cursor=$NEXT_CURSOR"
```

The same cursor pattern is used by filled orders, closed positions, and scaled
orders. Each endpoint returns its own opaque cursor. Never reuse a cursor with
a different endpoint, account, or filter.

The opaque cursor preserves the exact position in Convex's compound index, so
orders sharing the same millisecond are not skipped. A page returns at most
`limit` indexed rows, keeping work bounded independently of total account
history.