> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predexon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crypto Up/Down Markets

> List crypto up/down prediction markets

Bitcoin, Ethereum, Solana, XRP, HYPE, Dogecoin, and BNB up/down markets across all timeframes (5m, 15m, 1h, 4h, daily). Filter by asset, timeframe, status, and time range.

<Tip>**Free & Unlimited.** This endpoint does not count toward your monthly usage limits on any plan.</Tip>

| Constraint | Value              |
| ---------- | ------------------ |
| `limit`    | 1–200 (default 50) |
| `offset`   | No limit           |


## OpenAPI

````yaml GET /v2/polymarket/crypto-updown
openapi: 3.1.0
info:
  title: Predexon API
  description: Prediction market data aggregation and matching API
  version: 2.0.0
servers:
  - url: https://api.predexon.com
security:
  - apiKey: []
paths:
  /v2/polymarket/crypto-updown:
    get:
      tags:
        - polymarket
      summary: Get Crypto Updown
      description: >-
        List crypto up/down prediction markets.


        Returns Bitcoin, Ethereum, Solana, XRP, HYPE, Dogecoin, and BNB up/down

        markets across all timeframes (5m, 15m, 1h, 4h, daily). Supports
        filtering

        by asset, timeframe, status, and time range.


        **Common queries:**

        - Current open markets: `?status=open`

        - BTC 15m timeline: `?asset=btc&timeframe=15m&sort=asc`

        - Recent BTC 15m results:
        `?asset=btc&timeframe=15m&status=closed&limit=20`

        - Time window: `?end_after=<unix_ts>&end_before=<unix_ts>&sort=asc`
      operationId: get_crypto_updown_v2_polymarket_crypto_updown_get
      parameters:
        - name: asset
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/CryptoAsset'
              - type: 'null'
            description: 'Filter by crypto asset: btc, eth, sol, xrp, hype, doge, bnb'
            title: Asset
          description: 'Filter by crypto asset: btc, eth, sol, xrp, hype, doge, bnb'
        - name: timeframe
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/CryptoTimeframe'
              - type: 'null'
            description: 'Filter by timeframe: 5m, 15m, 1h, 4h, daily'
            title: Timeframe
          description: 'Filter by timeframe: 5m, 15m, 1h, 4h, daily'
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/StatusFilter'
              - type: 'null'
            description: 'Filter by market status: open, closed'
            title: Status
          description: 'Filter by market status: open, closed'
        - name: end_after
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
            description: Only markets with end_time after this Unix timestamp
            title: End After
          description: Only markets with end_time after this Unix timestamp
        - name: end_before
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
            description: Only markets with end_time before or at this Unix timestamp
            title: End Before
          description: Only markets with end_time before or at this Unix timestamp
        - name: sort
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/SortOrder'
            description: 'Sort by end_time: desc (most recent first) or asc (chronological)'
            default: desc
          description: 'Sort by end_time: desc (most recent first) or asc (chronological)'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: Number of markets to return
            default: 50
            title: Limit
          description: Number of markets to return
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Offset for pagination
            default: 0
            title: Offset
          description: Offset for pagination
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CryptoUpDownResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CryptoAsset:
      type: string
      enum:
        - btc
        - eth
        - sol
        - xrp
        - hype
        - doge
        - bnb
      title: CryptoAsset
    CryptoTimeframe:
      type: string
      enum:
        - 5m
        - 15m
        - 1h
        - 4h
        - daily
      title: CryptoTimeframe
    StatusFilter:
      type: string
      enum:
        - open
        - closed
      title: StatusFilter
    SortOrder:
      type: string
      enum:
        - asc
        - desc
      title: SortOrder
    CryptoUpDownResponse:
      properties:
        markets:
          items:
            $ref: '#/components/schemas/CryptoUpDownMarket'
          type: array
          title: Markets
        pagination:
          $ref: '#/components/schemas/OffsetPagination'
      type: object
      required:
        - markets
        - pagination
      title: CryptoUpDownResponse
      description: Response for crypto up/down markets list endpoint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CryptoUpDownMarket:
      properties:
        condition_id:
          type: string
          title: Condition Id
        market_slug:
          type: string
          title: Market Slug
        title:
          type: string
          title: Title
        asset:
          type: string
          title: Asset
          description: 'Normalized asset code: btc, eth, sol, xrp'
        timeframe:
          type: string
          title: Timeframe
          description: 'Normalized timeframe: 15m, 1h, 4h, daily'
        status:
          type: string
          title: Status
        winning_side:
          anyOf:
            - type: string
            - type: 'null'
          title: Winning Side
          description: '''Up'', ''Down'', or null if unresolved'
        up_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Up Price
          description: Current Up outcome price (0-1)
        down_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Down Price
          description: Current Down outcome price (0-1)
        up_token_id:
          type: string
          title: Up Token Id
          description: Token ID for the Up outcome
        down_token_id:
          type: string
          title: Down Token Id
          description: Token ID for the Down outcome
        start_time:
          anyOf:
            - type: string
            - type: 'null'
          title: Start Time
          description: ISO 8601 timestamp
        end_time:
          anyOf:
            - type: string
            - type: 'null'
          title: End Time
          description: ISO 8601 timestamp
        total_volume_usd:
          type: number
          title: Total Volume Usd
          default: 0
        liquidity_usd:
          type: number
          title: Liquidity Usd
          default: 0
        event_slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Event Slug
        image_url:
          type: string
          title: Image Url
          default: ''
      type: object
      required:
        - condition_id
        - market_slug
        - title
        - asset
        - timeframe
        - status
        - up_token_id
        - down_token_id
      title: CryptoUpDownMarket
      description: A crypto up/down market (e.g., 'Bitcoin Up or Down - 15m').
    OffsetPagination:
      properties:
        limit:
          type: integer
          title: Limit
          description: Requested limit
        offset:
          type: integer
          title: Offset
          description: Current offset
        total:
          type: integer
          title: Total
          description: Total number of matching items
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more items available
      type: object
      required:
        - limit
        - offset
        - total
        - has_more
      title: OffsetPagination
      description: Offset-based pagination for markets list endpoints.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````