> For the complete documentation index, see [llms.txt](https://naviprotocol.gitbook.io/astros/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://naviprotocol.gitbook.io/astros/astros-perpetual/astros-api.md).

# Astros API

### Contents

| Page       | Description                                                            |
| ---------- | ---------------------------------------------------------------------- |
| Basic Info | Rules, access URLs, API key lifecycle, HMAC signing, response envelope |
| REST API   | Orders, positions, private queries, public market data                 |
| WebSocket  | Authenticated subscriptions, push payloads, and ping/pong keepalive    |

### Quick links

* REST: `https://api.astros.ag`
* WebSocket: `wss://api.astros.ag/api/market/ws`
* App / wallet login: <https://astros.ag>

### Conventions

* Timestamps are Unix **milliseconds**
* Private REST calls send `APIKEY` + `signature` headers
* Signatures are HMAC-SHA256 → **lowercase hex**
* Success responses use body `code: 200`