betfair_markets_by_event
Read-onlyIdempotent
Retrieve market structure—market IDs, names, and runners—for a single event ID, without exchange prices. Use with betfair_market_prices for pricing.
Instructions
Market STRUCTURE for an event (market ids, names, runners) — probed live 2026-07-06: this route STRIPS exchange prices (runners come back without the exchange block) and 400s on multi-id batches. For prices, feed the market ids into betfair_market_prices; for bulk market-id discovery, betfair_navigation with attachments=MENU,EVENT,MARKET returns 1000+ MARKET nodes per event type in one call.
Returns: {currencyCode, eventTypes:[{eventNodes:[{eventId, event:{eventName}, marketNodes:[{marketId, description:{marketType}, state, runners:[{...prices}]}]}]}]}
Auth: none needed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _ak | No | Public web app key (leave default). | nzIFcwyWhrlwYMrh |
| alt | No | Response format. | json |
| types | No | Which data sections to include (CSV). | MARKET_STATE,MARKET_RATES,MARKET_DESCRIPTION,EVENT,RUNNER_DESCRIPTION,RUNNER_STATE,RUNNER_EXCHANGE_PRICES_BEST,RUNNER_METADATA,MARKET_LINE_RANGE_INFO |
| locale | No | Locale. | en |
| eventIds | Yes | Event ids, e.g. 35652256 (from betfair_navigation EVENT nodes). Prefer ONE id per call — multi-id batches return 400. | |
| rollupLimit | No | Price-ladder depth to roll up. | |
| rollupModel | No | Roll-up model. | STAKE |
| currencyCode | No | Currency for prices/volumes. | AUD |