# BetDEX API ## Docs - [Fetch a list of supported currencies](https://developers.betdex.com/api-reference/currencies/fetch-a-list-of-supported-currencies.md): Returns the list of currencies supported by the exchange - [Fetch currency by its ID](https://developers.betdex.com/api-reference/currencies/fetch-currency-by-its-id.md): Returns the currency or 404 - [Fetch all event categories](https://developers.betdex.com/api-reference/event-categories/fetch-all-event-categories.md) - [Fetch event category by id](https://developers.betdex.com/api-reference/event-categories/fetch-event-category-by-id.md) - [Fetch all event groups](https://developers.betdex.com/api-reference/event-groups/fetch-all-event-groups.md) - [Fetch event group by external reference](https://developers.betdex.com/api-reference/event-groups/fetch-event-group-by-external-reference.md) - [Fetch event group by id](https://developers.betdex.com/api-reference/event-groups/fetch-event-group-by-id.md) - [Fetch events participants for a given subcategory id](https://developers.betdex.com/api-reference/event-subcategories/fetch-events-participants-for-a-given-subcategory-id.md) - [Fetch subcategories by categories](https://developers.betdex.com/api-reference/event-subcategories/fetch-subcategories-by-categories.md) - [Fetch subcategory by external reference](https://developers.betdex.com/api-reference/event-subcategories/fetch-subcategory-by-external-reference.md) - [Fetch subcategory by id](https://developers.betdex.com/api-reference/event-subcategories/fetch-subcategory-by-id.md) - [Fetch event by external reference](https://developers.betdex.com/api-reference/events/fetch-event-by-external-reference.md) - [Fetch event by id](https://developers.betdex.com/api-reference/events/fetch-event-by-id.md) - [Fetch events](https://developers.betdex.com/api-reference/events/fetch-events.md): Fetch events by ids, categories, sub-categories, event groups and/or from/to dates - [Fetch events participants for a given event id](https://developers.betdex.com/api-reference/events/fetch-events-participants-for-a-given-event-id.md) - [Fetch external reference sources](https://developers.betdex.com/api-reference/external-reference-sources/fetch-external-reference-sources.md) - [Fetch market price ladder](https://developers.betdex.com/api-reference/market-prices/fetch-market-price-ladder.md) - [Fetch market prices](https://developers.betdex.com/api-reference/market-prices/fetch-market-prices.md) - [Fetch all market types](https://developers.betdex.com/api-reference/market-types/fetch-all-market-types.md) - [Fetch market type by id](https://developers.betdex.com/api-reference/market-types/fetch-market-type-by-id.md) - [Fetch market by external reference](https://developers.betdex.com/api-reference/markets/fetch-market-by-external-reference.md) - [Fetch market by id](https://developers.betdex.com/api-reference/markets/fetch-market-by-id.md) - [Fetch market orders](https://developers.betdex.com/api-reference/markets/fetch-market-orders.md): Fetch market orders by wallets. Page size limit 500 - [Fetch market positions](https://developers.betdex.com/api-reference/markets/fetch-market-positions.md): Fetch market positions by wallets - [Fetch market prices](https://developers.betdex.com/api-reference/markets/fetch-market-prices.md) - [Fetch market prices](https://developers.betdex.com/api-reference/markets/fetch-market-prices-1.md) - [Fetch markets](https://developers.betdex.com/api-reference/markets/fetch-markets.md): Returns a paginated list of markets based on the provided filter and ordering criteria. This can get specific known markets (by market ID), or markets based on other criteria such as event ID(s) and/or market type and status etc. - [Cancel order by id](https://developers.betdex.com/api-reference/orders/cancel-order-by-id.md): Cancel order by id. Pending orders will be updated with matchBehavior: CancelUnmatched, and any remaining unmatched stake after processing will be cancelled. - [Cancel order by id](https://developers.betdex.com/api-reference/orders/cancel-order-by-id-1.md): Pending orders will be updated with matchBehavior: CancelUnmatched, and any remaining unmatched stake after processing will be cancelled. - [Cancel orders in batch](https://developers.betdex.com/api-reference/orders/cancel-orders-in-batch.md): Cancel orders owned by the caller by event and/or market; skips invalid markets/orders. Pending orders will be updated with matchBehavior: CancelUnmatched, and any remaining unmatched stake after processing will be cancelled. - [Cancel orders in batch](https://developers.betdex.com/api-reference/orders/cancel-orders-in-batch-1.md): Cancel orders owned by the caller by event and/or market; skips invalid markets/orders. Pending orders will be updated with matchBehavior: CancelUnmatched, and any remaining unmatched stake after processing will be cancelled. - [Create an order request (Coming soon) ](https://developers.betdex.com/api-reference/orders/create-an-order-request-coming-soon.md): Submit a request to create an order and get back an acknowledgement response containing the order's ID immediately. An order with a status of Pending will be created immediately in order to generate an ID; Any in-play/BIR delay, as well as initial matching will be performed asynchronously. Updates a… - [Create an order request (Coming soon)](https://developers.betdex.com/api-reference/orders/create-an-order-request-coming-soon-1.md): Submit a request to create multiple orders and get back an acknowledgement response containing the orders' ID's immediately. Orders with status of Pending will be created immediately in order to generate IDs; Any in-play/BIR delay, as well as initial matching will be performed asynchronously. The or… - [Create multiple orders](https://developers.betdex.com/api-reference/orders/create-multiple-orders.md) - [Create order](https://developers.betdex.com/api-reference/orders/create-order.md) - [Fetch order by id](https://developers.betdex.com/api-reference/orders/fetch-order-by-id.md) - [Fetch order by reference](https://developers.betdex.com/api-reference/orders/fetch-order-by-reference.md) - [Fetch orders by filters.](https://developers.betdex.com/api-reference/orders/fetch-orders-by-filters.md): Fetch orders by filters. At least one of the following filter parameters must be supplied: ids, appIds, eventIds, marketIds, walletIds, references. Page size limit 500. - [Fetch orders settled in date range](https://developers.betdex.com/api-reference/orders/fetch-orders-settled-in-date-range.md): Fetch orders settled in date range, filtered by wallet (settled orders are those of status 'Won', 'Lost', or 'Voided'). Page size limit 500, max date range is 10 days. - [Fetch trades by order](https://developers.betdex.com/api-reference/orders/fetch-trades-by-order.md) - [Fetch participants by external reference](https://developers.betdex.com/api-reference/participants/fetch-participants-by-external-reference.md) - [Create a session](https://developers.betdex.com/api-reference/session-management/create-a-session.md): Create a session for the supplied credentials and receive access and refresh tokens. These tokens will be used for Bearer authentication, and passed as part of the authorization header where required. - [Refresh a session](https://developers.betdex.com/api-reference/session-management/refresh-a-session.md): Refresh an existing session using the refresh token. If a session's access token has expired but the refresh token is still valid, the existing session can be refreshed. New access and refresh tokens will be returned. - [Fetch a trade by ID](https://developers.betdex.com/api-reference/trades/fetch-a-trade-by-id.md) - [Fetch trades by markets, wallets and/or orders](https://developers.betdex.com/api-reference/trades/fetch-trades-by-markets-wallets-andor-orders.md) - [Credit wallet with test funds](https://developers.betdex.com/api-reference/wallets/credit-wallet-with-test-funds.md): Credit wallet with 1000 units of a given currency (only available on sandbox environment) - [Fetch a list of transactions](https://developers.betdex.com/api-reference/wallets/fetch-a-list-of-transactions.md): Fetch a list of transactions for the current user, filtered by the provided walletFilter param - [Fetch a wallet by id](https://developers.betdex.com/api-reference/wallets/fetch-a-wallet-by-id.md) - [Get Market Positions](https://developers.betdex.com/api-reference/wallets/get-market-positions.md): Fetch a list of market positions for the specified wallet, filtered by market ids - [Get Wallet Account Metrics](https://developers.betdex.com/api-reference/wallets/get-wallet-account-metrics.md): Fetch a set of wallet account metrics for given wallet-id and currency-id - [FAQs](https://developers.betdex.com/faqs.md) - [How to get my API key?](https://developers.betdex.com/how-to-get-my-api-key.md) - [Welcome](https://developers.betdex.com/index.md): BetDEX Exchange API documentation overview - [REST API Overview](https://developers.betdex.com/rest-api/overview.md): Introduction to the BetDEX REST API for managing events, markets, sessions, wallets, and orders. - [Stream API](https://developers.betdex.com/stream-api.md): Real-time WebSocket subscriptions for events, markets, orders, and wallets. ## OpenAPI Specs - [exchange-openapi-wallet-key](https://developers.betdex.com/openapi/exchange-openapi-wallet-key.json)