API ReferenceList Markets

List Markets

GEThttps://api.testnet.lucyd.trade/markets

Returns markets sorted by end_date, newest first by default. Every item has type: "market".

Filters that take a list accept comma-separated values: a market matches if it has any of them. Different filters combine with AND. Names are case-insensitive.

Query Parameters

ParamTypeDescription
addressstringMarket address, or several comma-separated.
statestringopen · upcoming · pending · settled · voided
instrumentstringUnderlying asset: BTC
market_typestringUpDown
periodstringExpiry period as returned in period: 5m · 15m · 30m · 1h · 4h · Daily
categorystringe.g. Crypto
end_fromintegerend_date from, unix seconds, inclusive
end_tointegerend_date until, unix seconds, exclusive
orderstringBy end_date: desc (default) or asc
limitintegerMax items, 1–1000. Default 100.
offsetintegerItems to skip, for paging. Default 0, max 10000.
bash
curl 'https://api.testnet.lucyd.trade/markets?market_type=UpDown&period=15m&state=open,upcoming&order=asc&limit=10'
json
[
  {
    "type": "market",
    "address": "0xC345e876Fde6d007AA54b6Dc374B1fB6de110b3b",
    "instrument": "BTC",
    "market_type": "UpDown",
    "period": "Daily",
    "title": "Will BTC go up or down today?",
    "category": "Crypto",
    "outcomes": [
      "up",
      "down"
    ],
    "state": "open",
    "start_date": "2026-09-28T00:00:00Z",
    "end_date": "2026-09-29T00:00:00Z",
    "resolved_at": null,
    "winner": null,
    "volume_traded": 284.5,
    "strike": 6250000000000,
    "rules": "Resolves Up if the Pyth BTC/USD price at expiry is strictly greater than the strike recorded at open, Down otherwise.",
    "resolved_value": null,
    "resolver_address": "0xe051D7D72DEb54F934F5DFa0846779232e7265dD",
    "oracle": {
      "provider": "pyth",
      "feeds": [
        {
          "id": "0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43",
          "name": "BTC/USD",
          "url": "https://pyth.network/price-feeds/crypto-btc-usd"
        }
      ]
    }
  }
]
To page through history, repeat the request with offset increased by limit until fewer than limit items come back. offset stops at 10000: to go further back, page by end_from / end_to windows.