API Reference

Complete reference for all Arbiter API endpoints.

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

Method	Endpoint	Description
GET	/v1/markets	List markets with filters
GET	/v1/markets/search	Full-text search with advanced filters
GET	/v1/markets/{id}	Get a single market

Market Data

Method	Endpoint	Description
GET	/v1/markets/{id}/price	Current or historical price
GET	/v1/markets/{id}/orderbook	Live orderbook
GET	/v1/markets/{id}/orderbook/history	Historical orderbook snapshots
GET	/v1/markets/{id}/trades	Trade history
GET	/v1/markets/{id}/candles	OHLCV candlestick data

Events

Method	Endpoint	Description
GET	/v1/events	List events (grouped markets)
GET	/v1/events/{slug}	Get event with child markets

WebSocket

Protocol	Endpoint	Description
WS	/v1/ws	Real-time trades, prices, orderbook

System

Method	Endpoint	Description
GET	/health	Health check (no auth)
GET	/v1/stats	Database 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"
}

Status	Meaning
400	Bad request (invalid params)
401	Missing or invalid API key
404	Resource not found
429	Rate limit exceeded
500	Server error