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

# History

> Paginated order and trade history across all connected exchanges

Look up past orders and fills across every connected exchange.

<Info>
  **Prerequisites:** an active VOOI API token and at least one connected exchange. See [API Tokens](/docs/tokens) and [Use your own keys](/docs/exchanges) if you don't have them yet.
</Info>

## Endpoints

* [`GET /exchange/orders`](/docs/api-reference/exchange/get-order-history) — paginated order history.
* [`GET /exchange/trades`](/docs/api-reference/exchange/get-trade-history) — paginated trade (fill) history.

Order-history rows carry the same shape as open orders, including `filledSize` — the size already executed, in base-asset units, or `null` where the venue does not report it or the order predates the field.

Both endpoints accept `exchanges`, `cursor`, and `limit`, and return `{ cursor, items }`. Order history additionally accepts `orderBy` (`updatedAt` by default, or `createdAt`). `cursor` is `null` on the last page; pass it back on the next request to continue.

## Next steps

<CardGroup cols={2}>
  <Card title="Orders" icon="list" href="/docs/trading-orders">
    Place and cancel orders
  </Card>

  <Card title="Real-time updates" icon="bolt" href="/docs/trading-streams">
    SSE streams for live fills and order changes
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.