Skip to main content
GET
/
v1
/
series
List Series
curl --request GET \
  --url https://api.convallax.com/v1/series
{
  "success": true,
  "count": 126,
  "series": [
    {
      "seriesId": "98765432109876543210",
      "conditionId": "0xa4ddc18895cc7b14810283ef8f113939abffd3969c6a0e37f1897110c67e6f73",
      "yesClobTokenId": "51508280778202349361616850684455231843716212176724253736363122559269229712002",
      "strikeBps": 50,
      "expiry": 1782864000,
      "optionType": "call",
      "settled": false,
      "resolutionBps": null
    }
  ]
}
List all option series registered on ConvallaxCore. No authentication required — this is a public read endpoint. Do not send an X-API-Key header; it is neither required nor checked. Series are created by the protocol team via ConvallaxCore.createSeries() and indexed from on-chain SeriesCreated events. The index refreshes every 5 minutes. Use the query filters to narrow results — for example, to find all unsettled call options for a specific Polymarket market: 
curl "https://api.convallax.com/v1/series?conditionId=0xa4ddc1...&optionType=call&settled=false"
Series must exist on-chain before a quote request can be committed against them. If you need a market or strike/expiry combination that isn’t listed, contact support@convallax.com.

Query Parameters

​
conditionId
string

Filter by Polymarket condition ID (bytes32 hex).

​
optionType
enum<string>

Filter by option type.

Available options:
call,
put
​
settled
enum<string>

Filter by settled status.

Available options:
true,
false

Response

200 - application/json

List of matching series

​
success
boolean
​
count
integer

Number of series matching the filters.

Example:

126

​
series
object[]