Actions7
Overview
This node integrates with the Betfair Australia API to list competitions related to sports betting markets. It allows users to retrieve filtered lists of competitions based on various criteria such as event types, venues, market countries, and more. This is useful for applications that need to display or process up-to-date competition data from Betfair's Australian platform, such as betting apps, sports analytics tools, or automated betting workflows.
A practical example: A user wants to get all horse racing competitions in Australia starting within a specific date range and only those where in-play betting is enabled. They can configure filters accordingly and use this node to fetch relevant competitions dynamically.
Properties
| Name | Meaning |
|---|---|
| Filters | Collection of optional filters to narrow down the competitions returned. |
| - Event Type ID(s) | Comma-separated IDs representing event types (e.g., "7" for Horse Racing). |
| - Event ID(s) | Comma-separated list of specific event IDs to filter competitions by. |
| - Competition ID(s) | Comma-separated list of competition IDs to specifically include. |
| - 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 competitions. |
| - Venue(s) | Comma-separated venue names to restrict competitions to certain locations. |
| - Text Query | Free-text search string to match against event or competition names. |
| - Market Start From | Date/time to filter competitions with markets starting from this timestamp. |
| - Market Start To | Date/time to filter competitions with markets starting up to this timestamp. |
| - BSP Offered Only | Boolean flag to return only markets where the Betfair Starting Price (BSP) 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 | Option to filter by market betting type; choices are Odds, Line, Asian Handicap Double Line, Asian Handicap Single Line. |
| - With Orders | Option to filter markets by order status; choices include Pending, Execution Complete, Executable, Expired. |
| - Race Type | Option to filter race types; choices include No Filter, Thoroughbred Flat, Harness, Hurdle, Steeple. |
Output
The node outputs an array of JSON objects representing competitions matching the specified filters. Each object corresponds to a competition entity as returned by the Betfair Australia API. The exact structure depends on the API response but typically includes details like competition ID, name, associated events, and other metadata.
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 Betfair's identity service before making API calls.
- Network access to
https://identitysso.betfair.com.au/api/loginandhttps://api.betfair.com.au/exchange/betting/rest/v1.0/endpoints is required. - Uses Axios HTTP client internally for API requests.
Troubleshooting
- Authentication Failures: If login fails, check that the provided API credentials (app key, username, password) are correct and active. Error messages from the API are surfaced clearly.
- Missing Credentials: The node throws an error if no credentials are configured.
- Invalid Filters: Providing malformed or unsupported filter values may cause API errors. Ensure comma-separated strings are properly formatted without extra spaces.
- API Request Errors: Network issues or API downtime can cause request failures. The node reports detailed error messages including HTTP status and API error payloads when available.
- Empty Results: If no competitions match the filters, the output will be empty. Try broadening filter criteria.