API Questions
What API endpoints are available?
GX Exchange provides two API interfaces:
- REST API at
https://api.gx.exchange/v4/— for order placement, cancellation, account queries, and market data - WebSocket at
wss://ws.gx.exchange— for real-time orderbook, trade, and candle subscriptions
How do I authenticate API requests?
Authenticated endpoints require an EIP-712 typed data signature. Sign the request payload with your Ethereum private key using the GX Exchange domain separator. The signature is included in the request body or query parameters.
What are the rate limits?
| Tier | Requests/Minute |
|---|---|
| Free | 60 |
| Authenticated | 300 |
| GX Staker | 1,000 |
| Market Maker | 10,000 |
If you are rate limited, you will receive a 429 HTTP response. Wait and retry with exponential backoff.
Is there a testnet?
Yes. The testnet REST API is at https://testnet-api.gx.exchange/v4/ and the testnet WebSocket is at wss://testnet-ws.gx.exchange. Use testnet for development and testing before deploying to mainnet.
What data format does the API use?
All API responses are JSON. Pagination uses cursor-based pagination with next_cursor and has_more fields.
Where can I find full API documentation?
See GX Core Tools for complete endpoint documentation, request/response examples, and order signing guides.