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

# Build on Reya

Trading clients. Market data. Applications built on Reya.

{% hint style="warning" %}
**API migration required for September 28.** Reya v2 launches on September 28, 2026. This affects both spot and perpetual API integrations. Prepare and test against the order book API on devnet now, then switch your production client to the new contract at cutover. **Production API base URLs stay the same; individual endpoint paths change. The exact cutover time will be announced.** Use production signing configuration at launch. Read the [migration reference](https://docs.reya.xyz/developers/devnet/changelog/v2-migration) and [environment guidance](https://docs.reya.xyz/developers/devnet/getting-started/environments).
{% endhint %}

<figure><img src="https://2711203508-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXjKKcOKxsL2rjhSrwIVd%2Fuploads%2FU3SLtbujWk4hfSBwvP77%2Fdeveloper-hero.webp?alt=media" alt=""><figcaption></figcaption></figure>

Connect to the exchange. Stream the market. Make it yours.

## Choose your environment

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Mainnet AMM</strong></td><td>The current mainnet integration. Explore REST endpoints, WebSocket feeds, signing, and rate limits.<br><br><strong>Explore mainnet →</strong></td><td><a href="https://docs.reya.xyz/developers/mainnet/">https://docs.reya.xyz/developers/mainnet/</a></td></tr><tr><td><strong>Order Book · Devnet</strong></td><td>Build against the perpetual and spot order book on devnet1. Start with market data, then connect your trading client.<br><br><strong>Start building →</strong></td><td><a href="https://docs.reya.xyz/developers/devnet/getting-started/onboarding">https://docs.reya.xyz/developers/devnet/getting-started/onboarding</a></td></tr></tbody></table>

## From first request to first order

Start with a public market-data request on **Order Book devnet1**. No account or signer is needed for this step.

{% code title="Read perpetual market definitions · devnet1" %}

```bash
curl --fail --silent --show-error \
  https://api-devnet.reya-cronos.network/v2/perpMarketDefinitions
```

{% endcode %}

The response describes the available perpetual markets. Follow the [Quickstart](https://docs.reya.xyz/developers/devnet/getting-started/onboarding) to configure an account and signer, submit an order, and track its execution.

## Your integration toolkit

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>REST API</strong></td><td>Discover markets, manage orders, and query account data on devnet.</td><td><a href="https://docs.reya.xyz/developers/devnet/api-reference/rest-api-reference">https://docs.reya.xyz/developers/devnet/api-reference/rest-api-reference</a></td></tr><tr><td><strong>WebSocket feeds</strong></td><td>Stream order-book updates, order changes, and executions on devnet.</td><td><a href="https://docs.reya.xyz/developers/devnet/api-reference/websocket-api-reference">https://docs.reya.xyz/developers/devnet/api-reference/websocket-api-reference</a></td></tr><tr><td><strong>Python SDK</strong></td><td>Get started with the pinned devnet SDK snapshot and working examples.</td><td><a href="https://github.com/Reya-Labs/reya-python-sdk/tree/37450ccb2babc99398d1ac1290d48860a9a2e2fa">https://github.com/Reya-Labs/reya-python-sdk/tree/37450ccb2babc99398d1ac1290d48860a9a2e2fa</a></td></tr></tbody></table>

[Environments & endpoints](https://docs.reya.xyz/developers/devnet/getting-started/environments) · [Signing & authorization](https://docs.reya.xyz/developers/devnet/getting-started/signer-authorization) · [What's coming next](https://docs.reya.xyz/developers/devnet/under-development/whats-next)