Markets

List Markets

GET

Retrieve a paginated list of markets with filtering and sorting.

GET /api/v1/markets

Query Parameters

Parameter	Type	Default	Description
`limit`	number	50	Results per page (max 200)
`offset`	number	0	Pagination offset
`exchange`	string	-	Filter: `POLYMARKET` or `KALSHI`
`status`	string	-	Filter: `OPEN`, `RESOLVED`, `CLOSED`
`category`	string	-	Filter: `Politics`, `Sports`, `Crypto`, etc.
`search`	string	-	Search in market question
`sortBy`	string	`volume24h`	Sort: `volume`, `volume24h`, `liquidity`, `createdAt`
`sortOrder`	string	`desc`	Direction: `asc` or `desc`
`include`	string	-	Include: `outcomes`

Example

curl -H "Authorization: Bearer or_live_xxx" \
  "https://api.tessradar.com/api/v1/markets?limit=2&exchange=POLYMARKET&include=outcomes"

Response

{
  "data": [
    {
      "id": "e4ec57b5-94d1-4159-87c0-5bb6827928f7",
      "exchangeId": "POLYMARKET",
      "externalMarketId": "0xc111415f3e8d30...",
      "question": "Will Bitcoin reach $100k by end of 2026?",
      "status": "OPEN",
      "category": "Crypto",
      "liquidity": 926805.72,
      "volume": 10394552.81,
      "volume24h": 5524432.41,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "outcomes": [
        {
          "name": "Yes",
          "price": 0.652,
          "bestBidPrice": 0.65,
          "bestAskPrice": 0.67
        },
        {
          "name": "No", 
          "price": 0.348
        }
      ]
    }
  ],
  "pagination": {
    "total": 24664,
    "limit": 2,
    "offset": 0,
    "hasMore": true
  }
}

Cost: 1 credit per request

Get Market by ID

GET

Get detailed information for a single market including matched markets from other exchanges.

GET /api/v1/markets/{id}

Path Parameters

Parameter	Type	Description
`id`	string	Internal market UUID

Example

curl -H "Authorization: Bearer or_live_xxx" \
  "https://api.tessradar.com/api/v1/markets/e4ec57b5-94d1-4159-87c0-5bb6827928f7"

Response

{
  "data": {
    "id": "e4ec57b5-94d1-4159-87c0-5bb6827928f7",
    "exchangeId": "POLYMARKET",
    "externalMarketId": "0xc111415f3e8d30...",
    "question": "Will Bitcoin reach $100k by end of 2026?",
    "description": "This market resolves Yes if Bitcoin reaches $100,000...",
    "status": "OPEN",
    "category": "Crypto",
    "liquidity": 926805.72,
    "volume": 10394552.81,
    "volume24h": 5524432.41,
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2026-12-31T23:59:59.000Z",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-11T06:00:00.000Z",
    "outcomes": [
      {
        "id": "outcome-uuid",
        "name": "Yes",
        "price": 0.652,
        "bestBidPrice": 0.65,
        "bestAskPrice": 0.67
      },
      {
        "id": "outcome-uuid-2",
        "name": "No",
        "price": 0.348,
        "bestBidPrice": 0.34,
        "bestAskPrice": 0.36
      }
    ],
    "matchedMarkets": [
      {
        "id": "kalshi-market-id",
        "exchangeId": "KALSHI",
        "question": "Bitcoin to hit $100,000 in 2026?",
        "similarity": 0.92
      }
    ]
  }
}

Response Fields

Field	Type	Description
`id`	string	Internal UUID
`exchangeId`	string	`POLYMARKET` or `KALSHI`
`externalMarketId`	string	Platform's market ID
`question`	string	Market question
`description`	string	Full market description
`status`	string	`OPEN`, `RESOLVED`, or `CLOSED`
`category`	string	Market category
`liquidity`	number	Current liquidity in USD
`volume`	number	Total volume in USD
`volume24h`	number	24-hour volume in USD
`outcomes`	array	Outcome objects with prices
`matchedMarkets`	array	Similar markets on other exchanges

Cost: 1 credit per request

Markets

On this page