> For the complete documentation index, see [llms.txt](https://docs.aftermath.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aftermath.finance/for-developers/api/rest-api.md).

# REST API

About Aftermath REST API /api/...

All of our API endpoints are documented with the OpenAPI Spec and can be found here: <https://aftermath.finance/docs>.

Use the pages in this section for integration behavior that is easy to miss in the schema:

* [Signed Requests](/for-developers/api/rest-api/authentication.md) covers the reusable terms signature and the routes that use a different signing protocol.
* [Native Perpetuals](/for-developers/api/rest-api/native.md) covers account, market, vault, order, TWAP, and transaction-builder endpoints.
* [Errors](/for-developers/api/rest-api/error-handling.md) covers error formats, preview errors, and retry behavior.
* [Integration Notes](/for-developers/api/rest-api/gotchas.md) covers identifier types, BigInt wire values, sponsorship, and migration details.
* [Endpoint Inventory](/for-developers/api/rest-api/endpoint-inventory.md) lists every current production operation.

{% hint style="warning" %}
The production `POST /api/perpetuals/markets` response is `{ "marketDatas": [...] }`. The current OpenAPI component attached to that route incorrectly describes an `orderbooks` response; use the runtime response until the schema is corrected.
{% endhint %}
