Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

outcomeMeta

Returns Outcome events with nested markets, live trading gates, pricing, volume, open interest, settlement state, and instrument parameters.

Use cursor / limit for the discovery feed. Use eventSlug or marketSlugs for targeted lookups; with marketSlugs, markets=matched returns only the requested markets, while markets=event returns every market in each owning event. An eventSlug point lookup returns that event object directly; discovery and market-slug queries return the paged envelope.

sortBy=volume and sortBy=oi default to descending order. sortBy=endingSoon is an ascending semantic order and should be sent without sortOrder. Response metadata fields use snake_case.

This is an API-host aggregation, not a direct fullnode query. It combines the indexed event/market catalog with live trading gates and book-derived pricing, so it can briefly lag consensus or omit live prices when the book is empty.

The nested instrument object contains precision, fee-curve, tick, and size limits. settlement.winning_outcome is derived from outcomes and settlement_fraction after resolution. It is not the metadata provider's oracle result. trading and pricing are nullable on responses that have not been live-enriched.

POST/infotype outcomeMeta

Build the Outcome discovery feed or an event page: events, nested markets, live prices, settlement state.

Request body
exchangeIdinteger · uint32required
typestringrequired

Must be `outcomeMeta`.

"outcomeMeta"
categorystringnullableoptional
cursorstringnullableoptional
eventSlugstringnullableoptional
includeDelistedbooleanoptional
limitintegernullableoptional
marketsstringnullableoptional
"event""matched"null
marketSlugsstring[]optional
qstringnullableoptional
sortBystringnullableoptional
"volume""oi""endingSoon"null
sortOrderstringnullableoptional
"asc""desc"null
statusstringnullableoptional
tagstringnullableoptional
Request example
curl -X POST https://rpc.txflow-testnet.xyz/info \
  -H "Content-Type: application/json" \
  -H "x-api-version: 2026-08-16" \
  -d '{
  "type": "outcomeMeta",
  "exchangeId": 1,
  "limit": 20,
  "includeDelisted": false
}'
Try it
POST https://rpc.txflow-testnet.xyz/info
Response 200
codeinteger

`0` on success.

dataoneOf
oneOf · variant 1
eventsOutcomeMetaEvent[]
exchange_idinteger · uint32
has_moreboolean
next_cursorstringnullable
oneOf · variant 2
exchange_idinteger · uint32
marketsOutcomeMetaMarket[]
slugstring
titlestring
categorystringnullable
descriptionstringnullable
end_dateinteger · int64nullable
event_dateinteger · int64nullable
first_registered_atinteger · int64nullable
iconstringnullable
imagestringnullable
liquiditystringnullable
market_countinteger · uint64
metadata_pendingboolean
open_intereststring
parent_event_slugstringnullable
resolution_sourcestringnullable
series_slugstringnullable
source_of_truthstringnullable
start_dateinteger · int64nullable
start_timeinteger · int64nullable
statusstring
subcategorystringnullable
tag_slugsstring[]
volumestring
successboolean

`false` on error, with `code` set and the text in `message` instead of `data`.

Response example
{
  "success": true,
  "code": 0,
  "data": {
    "exchange_id": 1,
    "events": [
      {
        "slug": "btc-updown-5m-1787567400",
        "exchange_id": 1,
        "title": "Bitcoin Up or Down?",
        "description": "",
        "image": "",
        "icon": "",
        "category": "",
        "subcategory": "",
        "tag_slugs": [
          ""
        ],
        "series_slug": "",
        "parent_event_slug": "",
        "resolution_source": "",
        "source_of_truth": "",
        "end_date": 0,
        "event_date": 0,
        "start_date": 0,
        "start_time": 1700000000000,
        "market_count": 1,
        "first_registered_at": 0,
        "status": "active",
        "metadata_pending": false,
        "markets": [
          {
            "instrument_id": 19127212,
            "exchange_id": 1,
            "event_slug": "btc-updown-5m-1787567400",
            "slug": "btc-up-or-down-5m",
            "question": "Bitcoin Up or Down?",
            "title": "Bitcoin Up or Down?",
            "description": "",
            "image": "",
            "icon": "",
            "outcomes": [
              "Up",
              "Down"
            ],
            "resolution_mechanism": "",
            "resolution_source": "",
            "question_id": "",
            "group_item_title": "",
            "group_item_threshold": "",
            "start_date": 0,
            "event_start_time": 1787567400000,
            "end_date": 1787567700000,
            "template_id": "",
            "keyword_values": [
              [
                null
              ]
            ],
            "instrument": {
              "assets": [
                null
              ],
              "sz_decimals": 0,
              "fee_rate": "",
              "exponent": "",
              "maker_rebate_rate": "",
              "price_tick": "0",
              "max_limit_order_size": 0,
              "max_market_order_size": 0,
              "min_limit_order_size": "",
              "min_market_order_size": "",
              "min_limit_order_notional": "",
              "min_market_order_notional": ""
            },
            "settlement": {
              "resolution_status": "prepared",
              "settlement_fraction": "",
              "settlement_details": "",
              "resolved_at": 0,
              "winning_outcome": ""
            },
            "resolution_status": "prepared",
            "metadata_pending": false,
            "trading": {
              "accepting_orders": null,
              "closed": null
            },
            "pricing": {
              "best_bid": null,
              "best_ask": null,
              "last_trade_price": null,
              "spread": null
            },
            "volume": "12500.25",
            "open_interest": "8000",
            "liquidity": "",
            "open_price": "0"
          }
        ],
        "volume": "12500.25",
        "open_interest": "8000",
        "liquidity": ""
      }
    ],
    "next_cursor": "",
    "has_more": false
  }
}