API reference
Public API/Markets

Get market

GET/markets/{market_id}

Full metadata for a single market including categorization, basket assignment, and trading data.

120 requests / minute per key (read tier). Returns the {success, message, data} envelope.

Authorizations

Authorizationstringheaderrequired

Bearer token - an ito_* key (from Settings) holding the markets:read scope.

Path parameters

market_idstringrequired

Market identifier (ticker for Kalshi, token_id for Polymarket)

Query parameters

platformstring

Disambiguate if market_id exists on multiple platforms (polymarket or kalshi)

Request
curl "https://itomarkets.com/api/v1/markets/will-x-happen" \  -H "Authorization: Bearer $ITO_API_KEY"
ResponseJSON
{  "success": true,  "message": "Success",  "data": {    "market_id": "will-x-happen",    "platform": "polymarket",    "ticker": "will-x-happen",    "title": "Will X happen?",    "status": "open",    "volume": 120000.0,    "last_price": 0.61,    "market_type": "binary",    "main_category": "politics",    "basket_name": "middle-east-conflict",    "tags": [      "conflict",      "geopolitics"    ]  }}