List Swaps

curl --request GET \
  --url https://app.digitalsurge.com.au/api/private/swaps/ \
  --header 'Authorization: Bearer <token>'

{
  "count": 123,
  "results": [
    {
      "id": 123,
      "src_asset": "<string>",
      "dst_asset": "<string>",
      "bought_amount": "<string>",
      "sold_amount": "<string>",
      "src_fee": "<string>",
      "dst_fee": "<string>",
      "aud_value": "<string>",
      "req_get_amount": "<string>",
      "req_spend_amount": "<string>",
      "expected_price": "<string>"
    }
  ],
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}

Private

List Swaps

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.

Direction is implied by which asset is AUD:

BUY a crypto: src_asset="AUD", dst_asset=<crypto code>
SELL a crypto: src_asset=<crypto code>, dst_asset="AUD"

Listing returns swap history, most recent first. Retrieving by id returns the current state of a single swap — used after create to check whether status has moved from processing to processed, error, or canceled.

Placing a new swap is a two-step flow: estimate first to preview price, fees, and amounts, ask the user to confirm, then create to execute. See the per-operation documentation for details.

GET

api

private

swaps

List Swaps

curl --request GET \
  --url https://app.digitalsurge.com.au/api/private/swaps/ \
  --header 'Authorization: Bearer <token>'

{
  "count": 123,
  "results": [
    {
      "id": 123,
      "src_asset": "<string>",
      "dst_asset": "<string>",
      "bought_amount": "<string>",
      "sold_amount": "<string>",
      "src_fee": "<string>",
      "dst_fee": "<string>",
      "aud_value": "<string>",
      "req_get_amount": "<string>",
      "req_spend_amount": "<string>",
      "expected_price": "<string>"
    }
  ],
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}

Authorizations

Authorization

string

header

required

Personal API key, created in the Digital Surge app under Account Settings → API Keys. Send it with every request as Authorization: Bearer <your-api-key>.

Query Parameters

page

integer

A page number within the paginated result set.

page_size

integer

Number of results to return per page.

Response

200 - application/json

count

integer

required

Example:

123

results

object[]

required

Show child attributes

string<uri> | null

Example:

"http://api.example.org/accounts/?page=4"

string<uri> | null

Example:

"http://api.example.org/accounts/?page=2"

Get Profile Brief Create Swap

⌘I