Felo API PlatformFelo API Platform

Data API / Polymarket / Markets

Get Polymarket Markets

List individual Polymarket prediction markets — one binary question each — with live pricing. Use this when you need the market-implied probability of a specific outcome, or to screen markets by size and timing; filter with slug, condition_ids, clob_token_ids, tag_id, closed, and the volume_num_* / start_date_* / end_date_* ranges. Returns a top-level array of market objects. The probability signal is outcomes paired with outcomePrices, quoted against bestBid / bestAsk; conditionId and clobTokenIds are the on-chain identifiers you need to join to other Polymarket data. For the topic that groups several related questions together, use get_polymarket_events. For the same kind of question on the US-regulated Kalshi exchange, use get_kalshi_markets.

Параметры

запрос

  • limitintegerНеобязательный

    Maximum number of markets to return.

  • offsetintegerНеобязательный

    Number of markets to skip for offset-based pagination.

  • orderstringНеобязательный

    Comma-separated list of fields to order by.

  • ascendingbooleanНеобязательный

    Sort ascending when true.

  • idinteger[]Необязательный

    Filter by one or more Polymarket market IDs.

  • slugstring[]Необязательный

    Filter by one or more market slugs.

  • clob_token_idsstring[]Необязательный

    Filter by one or more CLOB token IDs.

  • condition_idsstring[]Необязательный

    Filter by one or more market condition IDs.

  • volume_num_minnumberНеобязательный

    Minimum total volume.

  • volume_num_maxnumberНеобязательный

    Maximum total volume.

  • start_date_minstringНеобязательный

    Filter markets starting after this ISO timestamp.

  • start_date_maxstringНеобязательный

    Filter markets starting before this ISO timestamp.

  • end_date_minstringНеобязательный

    Filter markets ending after this ISO timestamp.

  • end_date_maxstringНеобязательный

    Filter markets ending before this ISO timestamp.

  • tag_idintegerНеобязательный

    Filter by tag ID.

  • closedbooleanНеобязательный

    Filter by whether the market is closed.

  • include_tagbooleanНеобязательный

    Include tag metadata when true.

Пример запроса

curl -X GET "https://openapi.felo.ai/v1/beta/polymarket/markets" \
  -H "Authorization: Bearer $FELO_API_KEY"

Ответ

Поля ответа

  • idstringНеобязательный
  • questionstringНеобязательный
  • slugstringНеобязательный
  • conditionIdstringНеобязательный
  • clobTokenIdsНеобязательный

    Polymarket CLOB token IDs. The upstream Gamma API may encode this as a JSON string.

  • outcomesНеобязательный

    Market outcomes. The upstream Gamma API may encode this as a JSON string.

  • outcomePricesНеобязательный

    Outcome prices. The upstream Gamma API may encode this as a JSON string.

  • activebooleanНеобязательный
  • closedbooleanНеобязательный
  • liquiditystringНеобязательный
  • volumestringНеобязательный
  • volumeNumnumberНеобязательный
  • bestBidnumberНеобязательный
  • bestAsknumberНеобязательный
  • startDatestringНеобязательный
  • endDatestringНеобязательный
  • imagestringНеобязательный
  • iconstringНеобязательный
  • descriptionstringНеобязательный