Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Get Polymarket Markets

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Polymarket

​

Prediction-market discovery and market data.

Polymarket Operations

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.

Query Parameters
  • limit
    Type: integer
    min:  
    0

    Maximum number of markets to return.

  • offset
    Type: integer
    min:  
    0

    Number of markets to skip for offset-based pagination.

  • order
    Type: string

    Comma-separated list of fields to order by.

  • ascending
    Type: boolean

    Sort ascending when true.

  • id
    Type: array integer[]

    Filter by one or more Polymarket market IDs.

  • slug
    Type: array string[]

    Filter by one or more market slugs.

  • clob_token_ids
    Type: array string[]

    Filter by one or more CLOB token IDs.

  • condition_ids
    Type: array string[]

    Filter by one or more market condition IDs.

  • volume_num_min
    Type: number

    Minimum total volume.

  • volume_num_max
    Type: number

    Maximum total volume.

  • start_date_min
    Type: string Format: date-time

    Filter markets starting after this ISO timestamp.

  • start_date_max
    Type: string Format: date-time

    Filter markets starting before this ISO timestamp.

  • end_date_min
    Type: string Format: date-time

    Filter markets ending after this ISO timestamp.

  • end_date_max
    Type: string Format: date-time

    Filter markets ending before this ISO timestamp.

  • tag_id
    Type: integer

    Filter by tag ID.

  • closed
    Type: boolean

    Filter by whether the market is closed.

  • include_tag
    Type: boolean

    Include tag metadata when true.

Responses
  • 200
    Type: array object[]

    Top-level array of Polymarket market objects

    • active
      Type: boolean
    • bestAsk
      Type: number
    • bestBid
      Type: number
    • clobTokenIds

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

      • Type: string

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

    • closed
      Type: boolean
    • conditionId
      Type: string
    • description
      Type: string
    • endDate
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • icon
      Type: string
    • id
      Type: string
    • image
      Type: string
    • liquidity
      Type: string
    • outcomePrices

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

      • Type: string

        Outcome prices. 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.

      • Type: string

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

    • question
      Type: string
    • slug
      Type: string
    • startDate
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • volume
      Type: string
    • volumeNum
      Type: number
    • propertyName
      Type: anything
    application/json
  • 400
    Type: object

    Bad Request - Invalid parameters or validation errors

    • error
      Type: string
    • message
      Type: string
    application/json
  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 500
    Type: object

    Internal Server Error

    • error
      Type: string
    • message
      Type: string
    application/json
  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/polymarket/markets
curl https://openapi.felo.ai/v1/beta/polymarket/markets \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

[
  {
    "id": "540817",
    "question": "New Rihanna Album before GTA VI?",
    "slug": "new-rhianna-album-before-gta-vi-926",
    "conditionId": "0x1fad72fae204143ff1c3035e99e7c0f65ea8d5cd9bd1070987bd1a3316f772be",
    "clobTokenIds": "string",
    "outcomes": "string",
    "outcomePrices": "string",
    "active": true,
    "closed": true,
    "liquidity": "string",
    "volume": "string",
    "volumeNum": 1,
    "bestBid": 1,
    "bestAsk": 1,
    "startDate": "2026-09-30T03:09:45.799Z",
    "endDate": "2026-09-30T03:09:45.799Z",
    "image": "string",
    "icon": "string",
    "description": "string",
    "additionalProperty": "anything"
  }
]

Top-level array of Polymarket market objects

Get Polymarket Markets