Skip to main content

​
Base URL

https://api.arbiterapi.com
All endpoints (except /health) are prefixed with /v1 and require an X-API-Key header.

​
Authentication

curl https://api.arbiterapi.com/v1/markets \
  -H "X-API-Key: YOUR_API_KEY"

​
Endpoints

​
Markets

MethodEndpointDescription
GET/v1/marketsList markets with filters
GET/v1/markets/searchFull-text search with advanced filters
GET/v1/markets/{id}Get a single market

​
Market Data

MethodEndpointDescription
GET/v1/markets/{id}/priceCurrent or historical price
GET/v1/markets/{id}/orderbookLive orderbook
GET/v1/markets/{id}/orderbook/historyHistorical orderbook snapshots
GET/v1/markets/{id}/tradesTrade history
GET/v1/markets/{id}/candlesOHLCV candlestick data

​
Events

MethodEndpointDescription
GET/v1/eventsList events (grouped markets)
GET/v1/events/{slug}Get event with child markets

​
WebSocket

ProtocolEndpointDescription
WS/v1/wsReal-time trades, prices, orderbook

​
System

MethodEndpointDescription
GET/healthHealth check (no auth)
GET/v1/statsDatabase statistics

​
Pagination

List endpoints use offset-based pagination: 
curl ".../v1/markets?limit=50&offset=100"
Trade and orderbook history endpoints use cursor-based pagination: 
# First page
curl ".../v1/markets/{id}/trades?limit=100"
# Response includes: {"cursor": "1774399680782", "has_more": true}

# Next page
curl ".../v1/markets/{id}/trades?limit=100&cursor=1774399680782"

​
Errors

{
  "detail": "Market not found"
}
StatusMeaning
400Bad request (invalid params)
401Missing or invalid API key
404Resource not found
429Rate limit exceeded
500Server error