Actions7
Overview
This node integrates with the Betfair Australia API to retrieve various types of betting-related data. Specifically, the "List Events" operation fetches a list of sports events filtered by multiple criteria such as event type, competition, venue, market country, and more. This is useful for users who want to programmatically access up-to-date event information from Betfair Australia for purposes like monitoring upcoming races, analyzing markets, or building custom betting tools.
Practical examples include:
- Fetching all horse racing events in Australia starting within a specific date range.
- Searching for events at particular venues or competitions.
- Filtering events that are currently in-play or have markets with Betfair Starting Price (BSP) available.
Properties
| Name | Meaning |
|---|---|
| Filters | A collection of filters to narrow down the list of events returned. |
| - Event Type ID(s) | Comma-separated IDs representing event types (e.g., "7" for Horse Racing). |
| - Event ID(s) | Comma-separated specific event IDs to filter by. |
| - Competition ID(s) | Comma-separated competition IDs to filter events belonging to certain competitions. |
| - Market Country Code(s) | Comma-separated 2-letter country codes to filter markets by country (default is "AU"). |
| - Market Type Code(s) | Comma-separated market type codes (e.g., MATCH_ODDS, WIN) to filter markets. |
| - Venue(s) | Comma-separated venue names to filter events held at specific locations. |
| - Text Query | Free-text search string to match event or competition names. |
| - Market Start From | Date/time to filter markets starting from this timestamp. |
| - Market Start To | Date/time to filter markets starting up to this timestamp. |
| - BSP Offered Only | Boolean flag to return only markets where Betfair Starting Price is available. |
| - In-Play Enabled Only | Boolean flag to return only markets that will turn in-play. |
| - In-Play Now Only | Boolean flag to return only markets currently in-play. |
| - Market Betting Type | Select one of: Odds, Line, Asian Handicap Double Line, Asian Handicap Single Line. |
| - With Orders | Filter markets by order status: Pending, Execution Complete, Executable, Expired. |
| - Race Type | Filter race types: No Filter, Thoroughbred Flat, Harness, Hurdle, Steeple. |
Output
The node outputs an array of JSON objects representing the events matching the specified filters. Each object corresponds to an event and contains detailed information as provided by the Betfair Australia API, such as event IDs, names, start times, associated competitions, venues, and market details.
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 authentication via the Betfair Australia identity service before making API requests.
- Uses the Axios HTTP client library internally to communicate with the Betfair API endpoints.
- Network connectivity to
https://identitysso.betfair.com.au/api/loginandhttps://api.betfair.com.au/exchange/betting/rest/v1.0/is required.
Troubleshooting
- Authentication Failures: If login fails, errors such as "No token received" or API error messages may appear. Ensure that the API credentials (app key, username, password) are correct and active.
- Missing Required Parameters: For the "List Events" operation, filters are optional but providing relevant filters improves results. Incorrectly formatted comma-separated lists may cause empty or unexpected results.
- API Request Errors: Network issues or API downtime can cause request failures. Error responses from the API are logged and surfaced as node errors.
- Timeouts: Requests timeout after 15 seconds; slow network or large queries might require retrying or adjusting filters to reduce result size.
- Unknown Operation: If an unsupported operation is selected, the node throws an error indicating the operation is unhandled.