# Digital Surge API

> API documentation for Digital Surge, the Australian cryptocurrency exchange. Trade, track your portfolio, and automate with API keys or AI agents.

## Docs

- [LAUNCH](https://digitalsurge.com.au/docs/LAUNCH.md)
- [API Reference](https://digitalsurge.com.au/docs/api-reference/index.md): Complete reference for the Digital Surge API: market data, trading, portfolio, withdrawals, and account endpoints — with an interactive playground.
- [Add Address Book Entry](https://digitalsurge.com.au/docs/api-reference/private/add-address-book-entry.md): Saved withdrawal destinations for any asset.
- [Authorize Withdrawal](https://digitalsurge.com.au/docs/api-reference/private/authorize-withdrawal.md): Request a withdrawal to a saved address book entry and review past withdrawals.
- [Create Price Trigger](https://digitalsurge.com.au/docs/api-reference/private/create-price-trigger.md): Price alerts that watch an asset and optionally place a trade when the price is hit.
- [Create Recurring Buy](https://digitalsurge.com.au/docs/api-reference/private/create-recurring-buy.md): Recurring buys that automatically purchase an asset on a schedule — this is the **DCA / scheduled** trade flow. For instant one-shot trades, use the swaps endpoints instead.
- [Create Swap](https://digitalsurge.com.au/docs/api-reference/private/create-swap.md): Execute a previously estimated swap.
- [Create Withdrawal](https://digitalsurge.com.au/docs/api-reference/private/create-withdrawal.md): Request a withdrawal to a saved address book entry and review past withdrawals.
- [Delete Address Book Entry](https://digitalsurge.com.au/docs/api-reference/private/delete-address-book-entry.md): Soft delete by setting enabled=False
- [Delete Price Trigger](https://digitalsurge.com.au/docs/api-reference/private/delete-price-trigger.md): Price alerts that watch an asset and optionally place a trade when the price is hit.
- [Delete Recurring Buy](https://digitalsurge.com.au/docs/api-reference/private/delete-recurring-buy.md): Recurring buys that automatically purchase an asset on a schedule — this is the **DCA / scheduled** trade flow. For instant one-shot trades, use the swaps endpoints instead.
- [Disconnect AI Agent](https://digitalsurge.com.au/docs/api-reference/private/disconnect-ai-agent.md): Connected AI agents (MCP OAuth tokens) for the authenticated customer.
- [Estimate Swap](https://digitalsurge.com.au/docs/api-reference/private/estimate-swap.md): Preview the price, fees, and amounts for a swap without placing it.
- [Generate Account Statement PDF](https://digitalsurge.com.au/docs/api-reference/private/generate-account-statement-pdf.md): Generate a PDF account statement covering a chosen date range.
- [Generate EOFY Closing Statement PDF](https://digitalsurge.com.au/docs/api-reference/private/generate-eofy-closing-statement-pdf.md): Generate a PDF End-of-Financial-Year closing price statement.
- [Get Address Book Entry](https://digitalsurge.com.au/docs/api-reference/private/get-address-book-entry.md): Saved withdrawal destinations for any asset.
- [Get Asset Balance](https://digitalsurge.com.au/docs/api-reference/private/get-asset-balance.md): Return the total balance for a single asset.
- [Get Connected AI Agent](https://digitalsurge.com.au/docs/api-reference/private/get-connected-ai-agent.md): Connected AI agents (MCP OAuth tokens) for the authenticated customer.
- [Get Deposit Travel Rule](https://digitalsurge.com.au/docs/api-reference/private/get-deposit-travel-rule.md): Get current travel rule data for a deposit.
- [Get Portfolio Stats](https://digitalsurge.com.au/docs/api-reference/private/get-portfolio-stats.md): Crypto-only wallet statistics for the authenticated customer. Returns per-asset values, day/total returns, and (with ?overall=true) an aggregate AUD value of all crypto holdings. This endpoint does NOT include the customer's AUD cash balance — to report a total portfolio value (crypto + AUD), also c…
- [Get Price Trigger](https://digitalsurge.com.au/docs/api-reference/private/get-price-trigger.md): Price alerts that watch an asset and optionally place a trade when the price is hit.
- [Get Profile Brief](https://digitalsurge.com.au/docs/api-reference/private/get-profile-brief.md): Presentable profile information. Intended for use by AI agents and external integrations.
- [Get Recurring Buy](https://digitalsurge.com.au/docs/api-reference/private/get-recurring-buy.md): Recurring buys that automatically purchase an asset on a schedule — this is the **DCA / scheduled** trade flow. For instant one-shot trades, use the swaps endpoints instead.
- [Get Swap](https://digitalsurge.com.au/docs/api-reference/private/get-swap.md): Swap one asset directly for another at the current market price — this is the **instant / one-shot** trade flow. For recurring or scheduled buys (DCA), use the broker schedules endpoints instead.
- [Get Transaction](https://digitalsurge.com.au/docs/api-reference/private/get-transaction.md): Unified transaction history across every asset you hold.
- [Get Transaction Invoice](https://digitalsurge.com.au/docs/api-reference/private/get-transaction-invoice.md): Generate a PDF invoice for a wallet transaction.
- [Get Transaction Invoice](https://digitalsurge.com.au/docs/api-reference/private/get-transaction-invoice-1.md): Generate a PDF invoice for a transaction.
- [Get Transfer Limit](https://digitalsurge.com.au/docs/api-reference/private/get-transfer-limit.md): Your current transfer limits for deposits and withdrawals.
- [Get Wallet Transaction](https://digitalsurge.com.au/docs/api-reference/private/get-wallet-transaction.md): Wallet transactions for a given asset, with AUD-equivalent values.
- [Get Withdrawal](https://digitalsurge.com.au/docs/api-reference/private/get-withdrawal.md): Request a withdrawal to a saved address book entry and review past withdrawals.
- [List Address Book](https://digitalsurge.com.au/docs/api-reference/private/list-address-book.md): List address book entries with optional filtering.
- [List All Balances](https://digitalsurge.com.au/docs/api-reference/private/list-all-balances.md): Your whole portfolio holdings across every asset.
- [List All Transactions](https://digitalsurge.com.au/docs/api-reference/private/list-all-transactions.md): Unified transaction history across every asset you hold.
- [List Connected AI Agents](https://digitalsurge.com.au/docs/api-reference/private/list-connected-ai-agents.md): Connected AI agents (MCP OAuth tokens) for the authenticated customer.
- [List Deposit Addresses](https://digitalsurge.com.au/docs/api-reference/private/list-deposit-addresses.md): Your deposit address for a given asset.
- [List Price Triggers](https://digitalsurge.com.au/docs/api-reference/private/list-price-triggers.md): Price alerts that watch an asset and optionally place a trade when the price is hit.
- [List Recurring Buys](https://digitalsurge.com.au/docs/api-reference/private/list-recurring-buys.md): Recurring buys that automatically purchase an asset on a schedule — this is the **DCA / scheduled** trade flow. For instant one-shot trades, use the swaps endpoints instead.
- [List Swaps](https://digitalsurge.com.au/docs/api-reference/private/list-swaps.md): Swap one asset directly for another at the current market price — this is the **instant / one-shot** trade flow. For recurring or scheduled buys (DCA), use the broker schedules endpoints instead.
- [List Transfer Limits](https://digitalsurge.com.au/docs/api-reference/private/list-transfer-limits.md): Your current transfer limits for deposits and withdrawals.
- [List Wallet Transactions](https://digitalsurge.com.au/docs/api-reference/private/list-wallet-transactions.md): Wallet transactions for a given asset, with AUD-equivalent values.
- [List Withdrawals](https://digitalsurge.com.au/docs/api-reference/private/list-withdrawals.md): Request a withdrawal to a saved address book entry and review past withdrawals.
- [Patch Price Trigger](https://digitalsurge.com.au/docs/api-reference/private/patch-price-trigger.md): Price alerts that watch an asset and optionally place a trade when the price is hit.
- [Patch Recurring Buy](https://digitalsurge.com.au/docs/api-reference/private/patch-recurring-buy.md): Recurring buys that automatically purchase an asset on a schedule — this is the **DCA / scheduled** trade flow. For instant one-shot trades, use the swaps endpoints instead.
- [Resend Address Confirmation](https://digitalsurge.com.au/docs/api-reference/private/resend-address-confirmation.md): Resend confirmation email for an unconfirmed address book entry.
- [Resend Withdrawal Code](https://digitalsurge.com.au/docs/api-reference/private/resend-withdrawal-code.md): Request a withdrawal to a saved address book entry and review past withdrawals.
- [Submit Deposit Travel Rule](https://digitalsurge.com.au/docs/api-reference/private/submit-deposit-travel-rule.md): Submit travel rule data for a deposit.
- [Update Price Trigger](https://digitalsurge.com.au/docs/api-reference/private/update-price-trigger.md): Price alerts that watch an asset and optionally place a trade when the price is hit.
- [Update Recurring Buy](https://digitalsurge.com.au/docs/api-reference/private/update-recurring-buy.md): Recurring buys that automatically purchase an asset on a schedule — this is the **DCA / scheduled** trade flow. For instant one-shot trades, use the swaps endpoints instead.
- [Get Asset](https://digitalsurge.com.au/docs/api-reference/public/get-asset.md): Catalogue of every asset supported on the platform.
- [Get Asset Category](https://digitalsurge.com.au/docs/api-reference/public/get-asset-category.md): Asset categories used to group the catalogue (for example DeFi, Layer 1, Stablecoins).
- [Get Ticker](https://digitalsurge.com.au/docs/api-reference/public/get-ticker.md): Current buy and sell prices for every tradeable asset.
- [List Asset Categories](https://digitalsurge.com.au/docs/api-reference/public/list-asset-categories.md): Asset categories used to group the catalogue (for example DeFi, Layer 1, Stablecoins).
- [List Assets](https://digitalsurge.com.au/docs/api-reference/public/list-assets.md): Catalogue of every asset supported on the platform.
- [List EOFY Closing Prices](https://digitalsurge.com.au/docs/api-reference/public/list-eofy-closing-prices.md): Australian end-of-financial-year closing prices, by asset and year.
- [Top Assets Summary](https://digitalsurge.com.au/docs/api-reference/public/top-assets-summary.md): Curated summary of top gainers, top losers, newly listed, and most traded assets.
- [Agentic AI Connector (MCP)](https://digitalsurge.com.au/docs/guides/ai-agents.md): Connect Claude, ChatGPT, or any MCP-compatible AI agent to your Digital Surge account with the Agentic AI Connector. Check prices, review your portfolio, and trade crypto in AUD through natural conversation.
- [Authentication](https://digitalsurge.com.au/docs/guides/authentication.md): How to create a Digital Surge API key and authenticate your API requests with a Bearer token. Read-only and read & write keys, two-factor protection, and key safety.
- [Conventions](https://digitalsurge.com.au/docs/guides/conventions.md): Digital Surge API conventions: decimal amounts as strings, timestamps, pagination, asset codes, and error responses. Read this before parsing any response.
- [Quickstart](https://digitalsurge.com.au/docs/guides/quickstart.md): Make your first Digital Surge API call in under five minutes: fetch live crypto prices in AUD, read your balances, and quote a swap.
- [Rate limits](https://digitalsurge.com.au/docs/guides/rate-limits.md): Digital Surge API rate limits for read and write requests, and how to handle HTTP 429 responses.
- [Digital Surge API](https://digitalsurge.com.au/docs/index.md): Build on Australia's most user-friendly cryptocurrency exchange. Trade crypto in AUD, track your portfolio, and automate your strategy with the Digital Surge API.

## OpenAPI Specs

- [openapi](https://digitalsurge.com.au/docs/openapi.json)