Skip to main content

​
1. Get Your API Key

Sign up at arbiterapi.com/signup or create an account via the API: 
curl -X POST https://api.arbiterapi.com/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'
The response includes your API key: 
{
  "developer": { "id": "dev_...", "email": "you@example.com" },
  "api_key": "arb_live_abc123..."
}
Save your API key — it’s only shown once at creation time.

​
2. Make Your First Request

List the top markets by volume: 
curl https://api.arbiterapi.com/v1/markets?limit=5 \
  -H "X-API-Key: YOUR_API_KEY"

[
  {
    "id": "poly_0x24fb...",
    "question": "Will Israel launch a major ground offensive in Lebanon by March 31?",
    "status": "open",
    "outcomes": [
      { "label": "Yes", "price": 0.998, "price_cents": 100 },
      { "label": "No", "price": 0.002, "price_cents": 0 }
    ],
    "volume_24h": 20870737.0,
    "platforms": [{ "platform": "polymarket", "native_id": "0x24fb..." }]
  }
]

​
3. Get Market Data

​
Current Price

curl .../v1/markets/poly_0x24fb.../price \
  -H "X-API-Key: YOUR_API_KEY"

​
OHLCV Candles

curl ".../v1/markets/poly_0x24fb.../candles?interval=1h&start_ts=1774300000" \
  -H "X-API-Key: YOUR_API_KEY"

​
Trade History

curl ".../v1/markets/poly_0x24fb.../trades?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

​
4. Use an SDK

import { ArbiterClient } from '@arbiter/sdk';

const client = new ArbiterClient({ apiKey: 'YOUR_API_KEY' });

const markets = await client.markets.list({ limit: 10 });
const trades = await client.markets.trades('poly_0x24fb...', { limit: 20 });
const candles = await client.markets.candles('poly_0x24fb...', { interval: '1h' });

​
Next Steps