Actions7
Overview
This node integrates with the Betfair Australia API to retrieve live betting market data. Specifically, the "List Market Book(s)" operation fetches real-time odds and market book details for one or more specified market IDs. This is useful for users who want to monitor current betting prices, volumes, and order information on selected markets.
Common scenarios include:
- Tracking live odds and best offers for horse racing or other sports markets.
- Building dashboards or alerts based on market price changes.
- Analyzing market liquidity and traded volume in real time.
Example: A user inputs a list of market IDs representing ongoing horse races and receives detailed market books showing current best offers, traded volumes, and order statuses.
Properties
| Name | Meaning |
|---|---|
| Market IDs | One or more comma-separated market IDs to query (e.g., 1.12345678,1.87654321). These identify the specific betting markets to retrieve data for. |
| Market Book Options | Collection of options to customize the market book data returned: |
| - Price Data | Types of price data to include. Options: Best Offers, All Offers, Traded Volume. Default is Best Offers. |
| - Best Offers Depth | Number specifying how deep the best offers data should be if "Best Offers" is selected. Minimum value is 1; default is 3. |
| - Virtualise Prices? | Boolean flag indicating whether to include virtual prices in the response. Defaults to false. |
| - Order Projection | Which orders to include in the response. Options: All My Orders, My Executable Orders, My Execution Complete Orders, Do Not Include Orders. Default is All My Orders. |
| - Match Projection | How matched bets are aggregated. Options: No Rollup, Rolled Up by Price, Rolled Up by Average Price, Do Not Include Matches. Default is No Rollup. |
Output
The node outputs an array of JSON objects, each representing a market book corresponding to one of the requested market IDs. Each market book contains detailed live data such as:
- Current prices and available offers according to the selected price data options.
- Depth of best offers if configured.
- Virtual prices if enabled.
- Information about the user's orders filtered by the chosen order projection.
- Matched bet data aggregated per the match projection setting.
The output structure directly reflects the Betfair API's market book response format, providing comprehensive live market state information.
No binary data output is produced by this operation.
Dependencies
- Requires valid Betfair Australia API credentials including an application key, username, and password.
- The node performs login via the Betfair identity service to obtain an authentication token before making API requests.
- Uses the Axios HTTP client library internally for API communication.
- Network access to Betfair Australia API endpoints is required.
Troubleshooting
- Missing Credentials: If no API credentials are provided, the node will throw an error instructing to add them.
- Login Failures: Errors during login (e.g., invalid username/password or app key) result in descriptive errors including any API error messages.
- Invalid Market IDs: If the Market IDs input is empty or improperly formatted, the node throws an error indicating that Market IDs are required.
- API Request Errors: Network issues or API errors return detailed messages including status codes and error payloads from Betfair.
- Timeouts: Requests have a timeout of 15 seconds; slow network or API issues may cause timeouts.
- Continue On Fail: If enabled, the node continues processing subsequent items even if some fail, returning error details in the output.
To resolve common errors:
- Verify API credentials and permissions.
- Ensure Market IDs are correctly formatted and valid.
- Check network connectivity to Betfair API endpoints.
- Review error messages for specific API error codes or messages.