Skip to main content
GET
/
v1
/
markets
List Markets
curl --request GET \
  --url https://api.convallax.com/v1/markets
{
  "success": true,
  "count": 2,
  "markets": [
    {
      "name": "Hantavirus pandemic in 2026?",
      "conditionId": "0xa4ddc18895cc7b14810283ef8f113939abffd3969c6a0e37f1897110c67e6f73",
      "yesClobTokenId": "51508280778202349361616850684455231843716212176724253736363122559269229712002",
      "seriesCount": 126,
      "strikes": [
        35,
        40,
        45,
        50,
        55,
        60,
        65,
        70,
        75
      ],
      "expiries": [
        1780272000,
        1782864000,
        1785542400
      ],
      "optionTypes": [
        "call",
        "put"
      ]
    }
  ]
}
No authentication required — this is a public read endpoint. Do not send an X-API-Key header; it is neither required nor checked. Start here to discover which markets are available. Each entry tells you:
  • conditionId — pass this to List Series to see every individual option series for that market.
  • strikes — which strike prices (in basis points) are available.
  • expiries — which expiry dates are available (Unix timestamps).
  • optionTypes — whether calls, puts, or both are listed.

​
Typical workflow

  1. Call GET /v1/markets to see what’s tradeable.
  2. Pick a market and call GET /v1/series?conditionId=0x... to browse its series.
  3. Open a quote request with the desired series parameters.

Response

200 - application/json

List of markets with option series

​
success
boolean
​
count
integer

Number of markets.

Example:

2

​
markets
object[]