Integrate markets, leaderboards, and events into your own apps. This page covers base URLs, authentication, endpoints, and common examples.
All requests are served over HTTPS. Use the base URL below for all REST endpoints.
https://api.insightarena.com/v1Authenticate by connecting a wallet, signing a challenge, and exchanging that signature for a short-lived bearer token.
Authorization: Bearer <token>Common endpoints are grouped below. Response bodies are JSON unless otherwise noted.
Fetch upcoming events and place an order. Replace identifiers with real values from your environment.
# List events
curl -s https://api.insightarena.com/v1/events | jq
# Create an order (authenticated)
curl -s https://api.insightarena.com/v1/markets/123/orders \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"side":"YES","amount":"25"}'Clients are rate-limited per IP and per token. When you exceed a limit, you will receive an HTTP 429.
| Code | Meaning | Typical Fix |
|---|---|---|
| 401 | Missing/invalid token | Re-authenticate |
| 403 | Insufficient permissions | Verify account/roles |
| 429 | Rate limited | Backoff + retry |
| 500 | Server error | Retry later |