Receive real-time event/market lifecycle updates

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://bump.sh/tie-tech/hub/b2b-api/doc/broker-asyncapi/mcp

Standard setup for AI tools providing an mcp.json file

{
  "broker-asyncapi MCP server": {
    "url": "https://bump.sh/tie-tech/hub/b2b-api/doc/broker-asyncapi/mcp"
  }
}

/events

Real-time lifecycle events stream for events and markets with resume capability.

Query Parameters:

since=<uint64> Last applied seq for resume (optional; must be >0; absent or 0 → start from live tail)
event_id=<id> Repeatable; filter by event_id (includes all markets of the event)
market_id=<id> Repeatable; filter by market_id
lang=<code> Repeatable; filter by language code (en, pt, id). Filters LocalizedText fields in payloads. If omitted, all available locales are included.

Resume Semantics:

Client connects with since=S (last applied seq)
Server replays frames with seq >= S in order
Sends backlog_end (last_seq = current max)
Continues live streaming If S > current max → immediate live (no backlog) If S too old (retention gap) → error frame (code=resume_too_old) then close (4009)

Idempotency / Ordering:

seq strictly monotonic; no gaps (gap ⇒ operational incident)
Client drops any frame with seq <= last_applied_seq
Expected next seq = last_applied_seq + 1 (else trigger reconnect + resume)

Event Types:

event.created: New event created with full definition
event.status_changed: Event status changed (only status fields)
event.settled: Event resolved (includes expiration_value and resolved_market_id; either may be null)
event.voided: Event cancelled (includes void_reason)
market.created: New market created with full definition
market.status_changed: Market status changed (only status fields)
market.details_changed: Market details changed (title, subtitles, floor_strike)
market.settled: Market resolved (includes result, settlement_price, expiration_value)
market.voided: Market cancelled

Market Details At Resolution:

market.details_changed can arrive on a closed market at resolution, with a new floor_strike
It always comes before market.settled and event.settled of the same event
expiration_value in those two events matches the new floor_strike, and can carry more decimals than usual

Heartbeats:

Sent when no lifecycle_update within configured interval
Heartbeat does NOT advance seq; only lifecycle_update frames advance seq
Heartbeat and backlog_end both repeat the last data seq

Flow Control:

Server may enforce max_pending_frames/bytes and close with code 4008 (flow_control)

Close Codes: 1000 normal 1001 going_away 1011 internal_error 4008 flow_control 4009 resume_too_old / protocol_version 4401 unauthorized

SUBSCRIBE /events

Event/Market Lifecycle Update Frame

Event or market lifecycle state change notification

Payload

type string Required

Value is event_update.
seq integer(int64) Required

Monotonic sequence for lifecycle events

Minimum value is 0.
ts_ns integer(int64) Required

Timestamp in nanoseconds
event_id string | null

Event ID (if applicable)
market_id string | null

Market ID (if applicable)
event_type string Required

Lifecycle event type

Values are event.created, event.status_changed, event.settled, event.voided, market.created, market.status_changed, market.details_changed, market.settled, or market.voided.
payload object Required
One of:
EventCreatedPayload object EventStatusChangedPayload object EventSettledPayload object EventVoidedPayload object MarketCreatedPayload object MarketStatusChangedPayload object MarketDetailsChangedPayload object MarketSettledPayload object MarketVoidedPayload object
Hide attributes Show attributes

event_id string Required

title object Required

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide title attributes Show title attributes object

en string

pt string

id string

series_title object | null

Localized title of the recurring series this event belongs to. Null when the event's template defines no series title. Absent in payloads emitted before this field was introduced.

Hide series_title attributes Show series_title attributes object | null

en string

pt string

id string

rules_primary object Required

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide rules_primary attributes Show rules_primary attributes object

en string

pt string

id string

category string Required

Values are crypto or forex.

image_url string

series string Required

Event series meta tag. Empty = standalone event. Non-empty values indicate the event belongs to a recurring series with the given interval.

Values are , 1min, 5min, 15min, 1h, 4h, or 1d.

status string Required

open: event is open, trading on markets is open or will be open (market statuses: unopened, pre-open, active, or suspended)

closed: event is closed, trading stopped, markets awaiting resolution and settlement

settled: all markets resolved and payouts completed

voided: event cancelled, all markets voided, contracts refunded

Values are open, closed, settled, or voided.

void_reason string | null

created_at string(date-time) Required

opens_at string(date-time) Required

closes_at string(date-time) Required

settlement_sources array[object] Required

Hide settlement_sources attributes Show settlement_sources attributes object

name string Required

url string Required

underlying object

Hide underlying attributes Show underlying attributes object

base_currency string Required

quote_currency string Required

markets array[string] Required

Array of market_ids belonging to this event
Hide attributes Show attributes

event_id string Required

old_status string Required

open: event is open, trading on markets is open or will be open (market statuses: unopened, pre-open, active, or suspended)

closed: event is closed, trading stopped, markets awaiting resolution and settlement

settled: all markets resolved and payouts completed

voided: event cancelled, all markets voided, contracts refunded

Values are open, closed, settled, or voided.

new_status string Required

open: event is open, trading on markets is open or will be open (market statuses: unopened, pre-open, active, or suspended)

closed: event is closed, trading stopped, markets awaiting resolution and settlement

settled: all markets resolved and payouts completed

voided: event cancelled, all markets voided, contracts refunded

Values are open, closed, settled, or voided.
Hide attributes Show attributes

event_id string Required

expiration_value string | null

Final asset value as string. Not necessarily a price, and not always numeric: it carries whatever value the settlement source publishes for the outcome. null if the resolution source publishes no closing value; the outcome is then carried by resolved_market_id, or by the per-market result when that is null too.

resolved_market_id string | null

Market ID of the winning market. null when no market won, and also when more than one won: this field carries a single winner and cannot express several. Read the per-market result to see the outcome of every market.

resolved_at string(date-time) Required

Actual resolution timestamp
Hide attributes Show attributes

event_id string Required

void_reason string Required

Reason for voiding the event
Hide attributes Show attributes

market_id string Required

Market ID

event_id string Required

market_index integer Required

Index of the market within the event

title object Required

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide title attributes Show title attributes object

en string

pt string

id string

yes_sub_title object | null

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide yes_sub_title attributes Show yes_sub_title attributes object | null

en string

pt string

id string

no_sub_title object | null

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide no_sub_title attributes Show no_sub_title attributes object | null

en string

pt string

id string

lower_bound object | null

Lower boundary for strike range (NULL for first market)

Hide lower_bound attributes Show lower_bound attributes object | null

units integer(int64) Required

nanos integer(int32) Required

Minimum value is -999999999, maximum value is 999999999.

upper_bound object | null

Upper boundary for strike range (NULL for last market)

Hide upper_bound attributes Show upper_bound attributes object | null

units integer(int64) Required

nanos integer(int32) Required

Minimum value is -999999999, maximum value is 999999999.

lower_inclusive boolean

Whether lower_bound is inclusive in the range

upper_inclusive boolean

Whether upper_bound is inclusive in the range

status string Required

unopened: created, not initialized in CLOB

pre-open: loaded in CLOB (MM can already place liquidity)

suspended: market open, but new orders are temporarily declined

active: market open for order acceptance

closed: closed, awaiting resolution; trading stopped, orders no longer accepted

settled: market resolved, payouts completed

voided: market cancelled, contracts refunded

Values are unopened, pre-open, active, suspended, closed, settled, or voided.

status_revision integer(int64) Required

Monotonic revision of the market status from Event Service

result string Required

Written when the event resolves, so it appears before the market reaches settled.

yes: YES is the winner

no: NO is the winner

empty: no result yet, or the market was voided

Values are yes, no, or .

created_at string(date-time) Required

opens_at string(date-time) Required

closes_at string(date-time) Required

expected_expiration_time string(date-time) Required

settlement_timer_seconds integer(int32) Required

can_close_early boolean Required

early_close_condition string | null

strike_type string Required

Values are greater, greater_or_equal, less, less_or_equal, between, or custom.

floor_strike object | null

Minimum expiration value that leads to a YES settlement

Hide floor_strike attributes Show floor_strike attributes object | null

units integer(int64) Required

nanos integer(int32) Required

Minimum value is -999999999, maximum value is 999999999.

cap_strike object | null

Maximum expiration value that leads to a YES settlement

Hide cap_strike attributes Show cap_strike attributes object | null

units integer(int64) Required

nanos integer(int32) Required

Minimum value is -999999999, maximum value is 999999999.

custom_strike string | null

Expiration value that leads to a YES settlement when strike_type=custom
Hide attributes Show attributes

status_revision integer(int64) Required

Monotonic revision of the market status from Event Service

market_id string Required

event_id string Required

old_status string Required

unopened: created, not initialized in CLOB

pre-open: loaded in CLOB (MM can already place liquidity)

suspended: market open, but new orders are temporarily declined

active: market open for order acceptance

closed: closed, awaiting resolution; trading stopped, orders no longer accepted

settled: market resolved, payouts completed

voided: market cancelled, contracts refunded

Values are unopened, pre-open, active, suspended, closed, settled, or voided.

new_status string Required

unopened: created, not initialized in CLOB

pre-open: loaded in CLOB (MM can already place liquidity)

suspended: market open, but new orders are temporarily declined

active: market open for order acceptance

closed: closed, awaiting resolution; trading stopped, orders no longer accepted

settled: market resolved, payouts completed

voided: market cancelled, contracts refunded

Values are unopened, pre-open, active, suspended, closed, settled, or voided.
Hide attributes Show attributes

market_id string Required

event_id string Required

title object Required

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide title attributes Show title attributes object

en string

pt string

id string

yes_sub_title object | null

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide yes_sub_title attributes Show yes_sub_title attributes object | null

en string

pt string

id string

no_sub_title object | null

Localized text content. When lang filter is applied, only requested locales are included. When lang filter is omitted, all available locales (en, pt, id) are included.

Hide no_sub_title attributes Show no_sub_title attributes object | null

en string

pt string

id string

floor_strike object | null

Minimum expiration value that leads to a YES settlement

Hide floor_strike attributes Show floor_strike attributes object | null

units integer(int64) Required

nanos integer(int32) Required

Minimum value is -999999999, maximum value is 999999999.

status_revision integer(int64) Required

Monotonic revision of the market status from Event Service
Hide attributes Show attributes

market_id string Required

event_id string Required

result string Required

Winner (YES or NO)

Values are yes or no.

settlement_price object Required

Hide settlement_price attributes Show settlement_price attributes object

units integer(int64) Required

nanos integer(int32) Required

Minimum value is -999999999, maximum value is 999999999.

expiration_value string | null

Final asset value as string. Not necessarily a price, and not always numeric: it carries whatever value the settlement source publishes for the outcome. null if the resolution source publishes no closing value, in which case the outcome is carried by result.

status_revision integer(int64) Required

Monotonic revision of the market status from Event Service
Hide attributes Show attributes

market_id string Required

event_id string Required

void_reason string Required

Reason for voiding the market

status_revision integer(int64) Required

Monotonic revision of the market status from Event Service

Payload examples

{
  "type": "event_update",
  "seq": 42,
  "ts_ns": 42,
  "event_id": "string",
  "market_id": "string",
  "event_type": "event.created",
  "payload": {
    "event_id": "string",
    "title": {
      "en": "string",
      "pt": "string",
      "id": "string"
    },
    "series_title": {
      "en": "string",
      "pt": "string",
      "id": "string"
    },
    "rules_primary": {
      "en": "string",
      "pt": "string",
      "id": "string"
    },
    "category": "crypto",
    "image_url": "string",
    "series": "",
    "status": "open",
    "void_reason": "string",
    "created_at": "2026-05-04T09:42:00Z",
    "opens_at": "2026-05-04T09:42:00Z",
    "closes_at": "2026-05-04T09:42:00Z",
    "settlement_sources": [
      {
        "name": "string",
        "url": "string",
        "underlying": {
          "base_currency": "string",
          "quote_currency": "string"
        }
      }
    ],
    "markets": [
      "string"
    ]
  }
}

Heartbeat Frame

Keep-alive heartbeat (does not advance seq)

Payload examples

{
  "type": "heartbeat",
  "seq": 42,
  "ts_ns": 42,
  "payload": {
    "interval_sec": 42
  }
}

Backlog End Marker

Signals end of historical replay; live streaming begins

Payload examples

{
  "type": "backlog_end",
  "seq": 42,
  "ts_ns": 42,
  "payload": {
    "last_seq": 42
  }
}

Error Frame

Error notification before close

Payload examples

{
  "type": "error",
  "seq": 42,
  "ts_ns": 42,
  "payload": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}