Refract FundingAPI docs
OpenAPIllms.txtGet API key

List markets

Search and list tradeable Kalshi and Polymarket markets.

GET/v1/marketsread scope

Returns the same universe the Refract app trades, liquidity-ordered, or relevance-ranked when q is present. A row with tradeable: false would currently reject BUY orders; re-check via Get market or Create quote before trading.

Query parameters

  • qstring

    Free-text search. Results come back relevance-ranked.

  • venue"ALL" | "KALSHI" | "POLYMARKET" | "PERP" | "UPDOWN"

    Default ALL. PERP = Kalshi perpetuals (dollar-priced). UPDOWN = rolling Up/Down windows; see List series for the roll schedule.

  • categorystring

    Category filter (e.g. crypto, sports, politics).

  • pageinteger

    1-based page. Default 1.

  • limitinteger

    Page size, max 100. Default 50.

Response

  • marketsarrayrequired

    Market rows: id, venue, venueMarketId (Kalshi ticker / Polymarket YES token id / perp ticker), slug (Polymarket market slug, itself a valid ref), title, eventTitle, outcomeNames, category, status, yesPrice (probability; dollar mark for perps), volume24hUsd, totalVolumeUsd, closeTime (ISO 8601), tradeable, instrument (BINARY | PERP), maxLeverage, fundingRate, liveWindow ({asset, timeframe, closeTime}).

  • page / pageSize / totalMarkets / hasMoreintegers + booleanrequired

    Pagination cursor state.

  • generatedAtstring

    ISO 8601 build time of the universe snapshot served.