Catapult API
The Catapult public API lets your code trade Synthetic markets, create and boost tokens, claim creator fees and stream prices and positions, using an API key from your own account.
The full guide and the reference for every operation, type and field are at api-docs.catapult.trade, generated from the live schema.
What the API covers
| Area | What your code can do |
|---|---|
| Synthetic trading | Open spot or leveraged positions, close them, set take-profit and stop-loss |
| Positions | Read closed positions, stream open ones with live PnL |
| Prices | Candles per token, live price ticks |
| Tokens | List and read Synthetic tokens, create your own, stream new ones |
| Boosters | See boost slots and prices, boost one of your tokens |
| Creator fees | Claim fees your tokens earned |
| Account | Read your balance and profile |
Not in the API: 10000x Futures, the Trading Competition, deposits, withdrawals, swaps, transfers and account settings. Use the app for those.
Endpoints
| Transport | URL |
|---|---|
| GraphQL over HTTP | https://public-api.catapult.trade/graphql |
| GraphQL over WebSocket | wss://public-api.catapult.trade/graphql |
Every operation except ping needs an API key, sent as Authorization: Bearer <key>. Create one in the app: see API keys.
Check the API is up, no key needed:
curl -s https://public-api.catapult.trade/graphql \
-H 'content-type: application/json' \
-d '{"query":"{ ping }"}'
# {"data":{"ping":"pong"}}
Reference sections
| Section | What it answers |
|---|---|
| Overview | Base endpoints, authentication, a first request |
| Units and conventions | USDT drops, leverageX10, collateral vs notional |
| Fees and position sizing | Open fee, notional caps, max position math |
| Token speed modes | Mode names and max leverage per mode |
| WebSocket API | Connect, subscribe, messages, errors |
| Rate limits | HTTP and WebSocket limits, response headers |
| Status codes | HTTP statuses and GraphQL error codes |
| Gotchas and idempotency | Sizing, rounding, take-profit and stop-loss details |
| API key OAuth | Letting a third-party bot use your key |
| Operations reference | Every query, mutation and subscription |