Changelog

This page is the record of changes to the Reya order-book integration surface — the REST API, the WebSocket order-entry and info APIs, and the on-chain settlement contracts (EIP-712 domains + addresses). If you integrate against Reya, watch this page.

Entries record changes, effective dates, and migration steps. See Our commitment for notice windows.

Stay notified

Breaking changes are mirrored to the Telegram announcements channel @reya_api_updates. This changelog remains the system of record.

How we manage changes

Surfaces

Surface	Where
REST API	REST API Reference
WebSocket — order entry	WS Order Entry API Reference
WebSocket — info	WS Info API Reference
On-chain settlement	Contract Addresses

What counts as breaking

A change is breaking if you must change code or config to keep working. For example: a removed or renamed field/endpoint; a changed type, default, or semantic; a new required field; a changed EIP-712 domain or contract address; changed auth/nonce rules; or tightened validation or rate limits.

Additive, backward-compatible changes (new optional fields, new endpoints, fixes) are not breaking and ship continuously — logged here, but without advance notice.

Our commitment

• Advance notice. Breaking changes get at least 15 calendar days advance notice on mainnet and at least 5 business days on devnet1, with the effective date stated in each entry.

• Cutovers. Breaking changes ship on a fixed, pre-announced date with the notice window plus a migration note. There is no old/new overlap — plan to switch over on the effective date.

• Emergency / security. Critical fixes may ship faster, with notice at or before rollout and a written rationale — the policy never blocks a security fix.

• devnet1 leads. Changes reach devnet1 before mainnet — validate against devnet1 before each mainnet effective date.

Legend

Each entry is tagged by surface and type:

• Surface — [REST] · [WS-OrderEntry] · [WS-Info] · [On-chain]

• Type — Added · Changed · Deprecated · Removed · Fixed

• 🔴 BREAKING — you must change your integration.

Log

2026-09-28 — Order book live on mainnet (API 3.6.2)

[REST] [WS-OrderEntry] [WS-Info] [On-chain] Added. The perpetual and spot order book is live on mainnet, serving API 3.6.2. See Environments for endpoints and signing values, and Contract Addresses for the on-chain settlement contracts.

This guide replaces both the pre-launch mainnet developer docs and the separate Order Book — Devnet guide. It documents mainnet and devnet1 together; devnet1 remains available for integration testing.