Skip to main content
Markets represent individual questions within an event. Each market has one or more outcomes (e.g., “Yes” / “No”), and each outcome has an associated token ID used in orderbooks.

​
List Markets

​
GET
List all markets, ordered by 24h volume (descending).

​
Query Parameters

​
limit
integer
default:"50"
Results per page (1-500)
​
min24hVolume
number
default:"0"
Minimum 24h volume filter
​
offset
integer
Offset for pagination
​
cursor_volume
number
Volume cursor for pagination
​
cursor_id
integer
Market ID cursor for pagination

​
Examples

Get top markets by volume: 
curl "https://poly-data.xyz/markets?limit=10"
Get markets with at least $10,000 daily volume: 
curl "https://poly-data.xyz/markets?min24hVolume=10000"
Response: 
{
  "limit": 10,
  "count": 10,
  "next": {
    "cursor_volume": 180000,
    "cursor_id": 5002
  },
  "data": [
    {
      "id": 5001,
      "event_id": 101,
      "question": "Will candidate A win?",
      "volume_24h": 250000,
      "volume_total": 5000000,
      "liquidity": 500000,
      "active": true,
      "closed": false
    },
    {
      "id": 5002,
      "event_id": 101,
      "question": "Will candidate B win?",
      "volume_24h": 180000,
      "volume_total": 3500000,
      "liquidity": 420000,
      "active": true,
      "closed": false
    }
  ]
}

​
Get Market

​
GET
Get a single market with its outcomes and token IDs.

​
Path Parameters

​
id
integer
required
Market ID

​
Example

curl "https://poly-data.xyz/markets/5001"
Response: 
{
  "id": 5001,
  "event_id": 101,
  "question": "Will candidate A win?",
  "description": "This market resolves to Yes if candidate A wins the election.",
  "active": true,
  "closed": false,
  "volume_24h": 250000,
  "volume_total": 5000000,
  "liquidity": 500000,
  "outcomes": [
    {
      "id": 1,
      "outcome_index": 0,
      "outcome": "Yes",
      "token_id": "abc123def456789..."
    },
    {
      "id": 2,
      "outcome_index": 1,
      "outcome": "No",
      "token_id": "def456abc789012..."
    }
  ]
}

​
Response Fields

FieldTypeDescription
idintegerUnique market identifier
event_idintegerParent event ID
questionstringThe market question
descriptionstringDetailed market description
activebooleanWhether the market is currently active
closedbooleanWhether the market has closed
volume_24hnumberTrading volume in the last 24 hours
volume_totalnumberAll-time trading volume
liquiditynumberCurrent liquidity in the market
outcomesarrayList of possible outcomes

​
Outcome Object

FieldTypeDescription
idintegerOutcome ID
outcome_indexintegerPosition index (0 for first outcome)
outcomestringOutcome name (e.g., “Yes”, “No”)
token_idstringToken ID used in orderbook queries
The token_id is what you’ll use as the asset_id parameter when querying orderbooks for a specific outcome.