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

# Outcome markets

> One row per HIP-4 outcome market from Hyperdash's outcome registry, newest outcome first.



## OpenAPI

````yaml /data-api/openapi.json get /v1/outcomes/markets
openapi: 3.1.0
info:
  title: Hyperdash Data API
  version: v1
  description: >-
    Hyperliquid data from Hyperdash's own nodes and stored datasets; requests
    never call Hyperliquid's public API. Every response reports the credits it
    cost.
servers:
  - url: https://data.hyperdash.com
security: []
tags:
  - name: Accounts
  - name: Async jobs
  - name: Builders
  - name: Cohorts
  - name: HIP-3 dexes
  - name: Leaderboards
  - name: Lending
  - name: Liquidations
  - name: Markets
  - name: 'Markets: analytics'
  - name: 'Markets: funding'
  - name: 'Markets: liquidation and stop levels'
  - name: 'Markets: open interest and positioning'
  - name: 'Markets: order book'
  - name: 'Markets: prices and candles'
  - name: 'Markets: queue priority'
  - name: 'Markets: trades and flow'
  - name: 'Markets: TWAPs'
  - name: Network
  - name: Outcomes
  - name: Positions
  - name: Referrals
  - name: Snapshots
  - name: Spot
  - name: Staking
  - name: Traders
  - name: Vaults
paths:
  /v1/outcomes/markets:
    get:
      tags:
        - Outcomes
      summary: Outcome markets
      description: >-
        One row per HIP-4 outcome market from Hyperdash's outcome registry,
        newest outcome first.


        **How it works**

        - Snapshots run every 5 minutes for active markets, so a settled market
        keeps its last pre-settlement open interest.

        - Listings without `outcome_id` or `question_id` look back 1 day for
        open interest. It is null beyond that.


        **Fields**

        - Each row has the Yes and No coins, the question it answers, names and
        description as published on chain, deployer venue, quote token, status,
        expiry and open interest.

        - A question is also called an event. Its outcomes are its possible
        answers, and `is_fallback` marks the catch-all one.

        - Open interest is minted Yes/No pairs, in shares at 1 USD face value,
        with the time of the market snapshot it comes from.


        **Notes**

        - No wallets are returned.


        **Credits:** 25 per request + 1 per row.


        **Scope:** `analytics:read`
      operationId: listOutcomeMarkets
      parameters:
        - name: status
          in: query
          required: false
          description: Market status.
          schema:
            type: string
            default: active
            enum:
              - active
              - settled
              - all
        - name: outcome_id
          in: query
          required: false
          description: One outcome.
          schema:
            type: integer
            minimum: 0
            maximum: 1000000000000000
        - name: question_id
          in: query
          required: false
          description: >-
            One question, also called an event. Returns its outcomes, including
            the fallback.
          schema:
            type: integer
            minimum: 1
            maximum: 1000000000000000
        - name: limit
          in: query
          required: false
          description: Outcomes to return, newest first.
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
      responses:
        '200':
          description: OK
          headers:
            X-Credits-Charged:
              schema:
                type: integer
            X-Credit-Price-Version:
              schema:
                type: integer
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - has_more
                  - next_cursor
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        outcome:
                          type: integer
                          description: Outcome id.
                        coin_yes:
                          type: string
                          description: >-
                            Yes-side coin, which is `#` followed by `outcome`
                            times 10, as in mids and trades.
                        coin_no:
                          type: string
                          description: >-
                            No-side coin, which is `#` followed by `outcome`
                            times 10 plus 1.
                        question_id:
                          type:
                            - integer
                            - 'null'
                          description: >-
                            Question (event) id. `null` for a standalone
                            outcome.
                        question_name:
                          type:
                            - string
                            - 'null'
                          description: Question name.
                        is_fallback:
                          type: boolean
                          description: >-
                            The question's fallback outcome, which is the
                            catch-all.
                        name:
                          type: string
                          description: Outcome name.
                        description:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Description as published, as `key:value` pairs
                            separated by `|`. `""` when published empty.
                        side0_name:
                          type: string
                          description: Yes-side name.
                        side1_name:
                          type: string
                          description: No-side name.
                        venue:
                          type:
                            - string
                            - 'null'
                          description: Deployer venue.
                        quote_token:
                          type:
                            - string
                            - 'null'
                          description: Quote token.
                        status:
                          type: string
                          description: '`active` or `settled`.'
                        first_seen_time:
                          type: integer
                          description: First seen by Hyperdash, in epoch milliseconds.
                        expiry_time:
                          type:
                            - integer
                            - 'null'
                          description: >-
                            Expiry, in epoch milliseconds (UTC). It is the
                            registry's expiry, or else the description's `time`,
                            `dateTime` or `*Deadline` key. `null` when none. For
                            a question's outcomes, the deadline sits on the
                            question.
                        expiry_raw:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The expiry as published, in the form
                            `YYYYMMDD-HHMM`.
                        open_interest:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Open interest, which is minted Yes/No pairs, in
                            shares at 1 USD face value. `null` without a market
                            snapshot in reach. Decimal string.
                        oi_as_of:
                          type:
                            - integer
                            - 'null'
                          description: >-
                            Time of the market snapshot `open_interest` comes
                            from, in epoch milliseconds.
                        class:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Outcome class from its template, for example
                            `priceBinary`.
                        underlying:
                          type:
                            - string
                            - 'null'
                          description: Underlying market of a price outcome.
                        period:
                          type:
                            - string
                            - 'null'
                          description: Period of a recurring outcome.
                        target_price:
                          type:
                            - string
                            - 'null'
                          description: Target price of a price outcome. Decimal string.
                        category:
                          type:
                            - string
                            - 'null'
                          description: Category.
                        sub_category:
                          type:
                            - string
                            - 'null'
                          description: Sub-category.
                        deployer_fee_scale:
                          type:
                            - string
                            - 'null'
                          description: Deployer fee scale. Decimal string.
                        settle_fraction:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Settlement, as the Yes-side payout share. `1` means
                            Yes won, `0` means No won and `0.5` means split.
                            `null` until settled. Decimal string.
                        settle_details:
                          type:
                            - string
                            - 'null'
                          description: Settlement details as published.
                        settled_at:
                          type:
                            - integer
                            - 'null'
                          description: >-
                            When Hyperdash's registry saw the outcome settled,
                            in epoch milliseconds. Its poll runs after the chain
                            settlement, so this is typically 20 to 30 seconds
                            after the outcome's Settlement fills, whose `time`
                            is the on-chain moment.
                    description: Result rows.
                  has_more:
                    type: boolean
                    description: '`true` when another page follows.'
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Cursor for the next page, passed as `cursor`. `null` on
                      the last page.
                  meta:
                    type: object
                    description: >-
                      Response metadata. Its keys depend on the endpoint and are
                      described above.
        '400':
          description: 'Invalid parameter (also: a request body that is not valid JSON)'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '401':
          description: Invalid, expired or revoked key
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Scope, plan, history or credit limit
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Price version changed, or a cursor's snapshot expired
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: >-
            Rate limited (Retry-After; free): request rate, concurrent requests
            (a request counts one slot per 1,000 rows it can return), or this
            server busy with your workspace's requests
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Upstream data source failed (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Backend at capacity or temporarily unavailable (Retry-After)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '504':
          description: Upstream data source timed out (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - bearer: []
      x-codeSamples:
        - lang: curl
          source: >-
            curl -H "Authorization: Bearer $HYPERDASH_API_KEY"
            'https://data.hyperdash.com/v1/outcomes/markets?status=active&limit=500'
components:
  schemas:
    Problem:
      type: object
      required:
        - type
        - title
        - status
        - code
        - request_id
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        code:
          type: string
        detail:
          type: string
        hint:
          type: string
        request_id:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: Your API key, sent as `Bearer hdk_sk_live_v1_…`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.