Swap API

The Swap API lets you exchange one stablecoin for another directly from a Blockradar wallet. Swaps can be initiated from a master wallet or a child address.

What you can do

Get a quote for a swap before committing
Quote by source amount or target amount with amountSide
Execute a swap between supported assets
Swap from both master wallets and child addresses
Route supported Stellar USDC destinations with the generic recipientRouting contract

Endpoints

Method	Endpoint	Description
`POST`	`/v1/wallets/{walletId}/swaps/quote`	Get swap quote from master wallet
`POST`	`/v1/wallets/{walletId}/swaps/execute`	Execute swap from master wallet
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/quote`	Get swap quote from child address
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/execute`	Execute swap from child address

Recipient parameters

Parameter	Type	Required	Description
`recipientAddress`	string	No	External recipient address. It remains a string, including for Stellar `G...` and `M...` addresses.
`recipientRouting`	object	No	Stellar-only routing choice: `{ type: "none" }` or `{ type: "memo_id", value: "<numeric string>" }`. Do not send it to EVM, Solana, or Tron destinations.

Stellar recipient routing

recipientRouting is supported only when the destination chain is Stellar. Existing EVM, Solana, and Tron swap requests are unchanged and must not send recipientRouting; requests that supply it are rejected. There is no separate recipient memo parameter. For supported Stellar USDC destinations:

Muxed M... recipient: omit recipientRouting. Its routing ID is already embedded in the address; sending routing data is rejected.
Base G... recipient with a routing ID: send recipientRouting: { type: "memo_id", value: "123" }. The value must be a non-empty numeric string from 0 through 18446744073709551615. Blockradar normalizes the destination to an M... address before requesting quote or execution.
Base G... recipient without a routing ID: send recipientRouting: { type: "none" } with no value. A G... recipient without recipientRouting is rejected. The destination base account must already have a Stellar USDC trustline before quote and execution.
Default Blockradar Stellar wallet: callers must explicitly send recipientRouting: { type: "none" }.

Stellar base account with a routing ID

{
  "recipientAddress": "G...",
  "recipientRouting": {
    "type": "memo_id",
    "value": "123"
  }
}

Stellar base account without a routing ID

{
  "recipientAddress": "G...",
  "recipientRouting": {
    "type": "none"
  }
}

Quote response metadata

Quote responses can include data.recipientRouting to explain the routing result. Execute responses do not include this metadata.

{
  "recipientRouting": {
    "status": "embedded",
    "message": "The recipient routing ID is embedded in the normalized destination address."
  }
}

Migrating from Stellar-only fields

Previous field	Use instead
`recipientMemoId`	`recipientRouting: { type: "memo_id", value: "<numeric string>" }`
`stellarMemoNotRequired: true`	`recipientRouting: { type: "none" }`

Full API Reference

View all swap endpoints in the API Reference tab.

Get Started

Wallets

Receive Payments

Send Payments

Convert & Manage

Compliance & Recovery

Integrations

What you can do

Endpoints

Recipient parameters

Stellar recipient routing

Quote response metadata

Migrating from Stellar-only fields

Full API Reference

​What you can do

​Endpoints

​Recipient parameters

​Stellar recipient routing

​Quote response metadata

​Migrating from Stellar-only fields

Full API Reference

What you can do

Endpoints

Recipient parameters

Stellar recipient routing

Quote response metadata

Migrating from Stellar-only fields