API reference
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" ] }}