Swap tokens
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/swap \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '
{
"base_amount": "1000000000000000000",
"amount_type": "exact_input",
"source": {
"asset_address": "native",
"caip2": "eip155:1"
},
"destination": {
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"caip2": "eip155:1"
},
"slippage_bps": 50
}
'HttpResponse<String> response = Unirest.post("https://api.privy.io/v1/wallets/{wallet_id}/swap")
.header("privy-app-id", "<privy-app-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"base_amount\": \"1000000000000000000\",\n \"amount_type\": \"exact_input\",\n \"source\": {\n \"asset_address\": \"native\",\n \"caip2\": \"eip155:1\"\n },\n \"destination\": {\n \"asset_address\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n \"caip2\": \"eip155:1\"\n },\n \"slippage_bps\": 50\n}")
.asString();const options = {
method: 'POST',
headers: {
'privy-app-id': '<privy-app-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
base_amount: '1000000000000000000',
amount_type: 'exact_input',
source: {asset_address: 'native', caip2: 'eip155:1'},
destination: {asset_address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', caip2: 'eip155:1'},
slippage_bps: 50
})
};
fetch('https://api.privy.io/v1/wallets/{wallet_id}/swap', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.privy.io/v1/wallets/{wallet_id}/swap",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'base_amount' => '1000000000000000000',
'amount_type' => 'exact_input',
'source' => [
'asset_address' => 'native',
'caip2' => 'eip155:1'
],
'destination' => [
'asset_address' => '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
'caip2' => 'eip155:1'
],
'slippage_bps' => 50
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"privy-app-id: <privy-app-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.privy.io/v1/wallets/{wallet_id}/swap"
payload := strings.NewReader("{\n \"base_amount\": \"1000000000000000000\",\n \"amount_type\": \"exact_input\",\n \"source\": {\n \"asset_address\": \"native\",\n \"caip2\": \"eip155:1\"\n },\n \"destination\": {\n \"asset_address\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n \"caip2\": \"eip155:1\"\n },\n \"slippage_bps\": 50\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("privy-app-id", "<privy-app-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "cm7oxq1el000e11o8iwp7d0d0",
"status": "pending",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"created_at": "2026-01-15T12:00:00.000Z",
"type": "swap",
"caip2": "eip155:1",
"input_token": "native",
"output_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"input_amount": "1000000000000000000",
"output_amount": null
}Swaps
Swap tokens
Execute a token swap within a wallet.
POST
/
v1
/
wallets
/
{wallet_id}
/
swap
Swap tokens
curl --request POST \
--url https://api.privy.io/v1/wallets/{wallet_id}/swap \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--header 'privy-app-id: <privy-app-id>' \
--data '
{
"base_amount": "1000000000000000000",
"amount_type": "exact_input",
"source": {
"asset_address": "native",
"caip2": "eip155:1"
},
"destination": {
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"caip2": "eip155:1"
},
"slippage_bps": 50
}
'HttpResponse<String> response = Unirest.post("https://api.privy.io/v1/wallets/{wallet_id}/swap")
.header("privy-app-id", "<privy-app-id>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"base_amount\": \"1000000000000000000\",\n \"amount_type\": \"exact_input\",\n \"source\": {\n \"asset_address\": \"native\",\n \"caip2\": \"eip155:1\"\n },\n \"destination\": {\n \"asset_address\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n \"caip2\": \"eip155:1\"\n },\n \"slippage_bps\": 50\n}")
.asString();const options = {
method: 'POST',
headers: {
'privy-app-id': '<privy-app-id>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
base_amount: '1000000000000000000',
amount_type: 'exact_input',
source: {asset_address: 'native', caip2: 'eip155:1'},
destination: {asset_address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', caip2: 'eip155:1'},
slippage_bps: 50
})
};
fetch('https://api.privy.io/v1/wallets/{wallet_id}/swap', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.privy.io/v1/wallets/{wallet_id}/swap",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'base_amount' => '1000000000000000000',
'amount_type' => 'exact_input',
'source' => [
'asset_address' => 'native',
'caip2' => 'eip155:1'
],
'destination' => [
'asset_address' => '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
'caip2' => 'eip155:1'
],
'slippage_bps' => 50
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json",
"privy-app-id: <privy-app-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.privy.io/v1/wallets/{wallet_id}/swap"
payload := strings.NewReader("{\n \"base_amount\": \"1000000000000000000\",\n \"amount_type\": \"exact_input\",\n \"source\": {\n \"asset_address\": \"native\",\n \"caip2\": \"eip155:1\"\n },\n \"destination\": {\n \"asset_address\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n \"caip2\": \"eip155:1\"\n },\n \"slippage_bps\": 50\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("privy-app-id", "<privy-app-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "cm7oxq1el000e11o8iwp7d0d0",
"status": "pending",
"wallet_id": "fmfdj6yqly31huorjqzq38zc",
"created_at": "2026-01-15T12:00:00.000Z",
"type": "swap",
"caip2": "eip155:1",
"input_token": "native",
"output_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"input_amount": "1000000000000000000",
"output_amount": null
}Optional setup
Configure gas sponsorship to cover network fees. Without sponsorship, the wallet pays network fees in the chain’s native token.Privy automates token approvals and transaction submission. The response is a wallet action that
starts in
pending status and can be polled for confirmation.Idempotency on errors: This endpoint returns
pending immediately. Replaying the same key
returns the cached response. On a synchronous 5xx, Privy deletes the record so the same key
retries fresh. Action outcomes (rejected, failed, succeeded) arrive via
webhooks and polling. Policy violations
always allow fresh retries.Authorizations
Headers
Body
application/json
Input for executing a token swap.
Response
200 - application/json
Swap initiated successfully.
Response for a swap action.
steps
(EVMTransactionWalletActionStep · object | EVMUserOperationWalletActionStep · object | SVMTransactionWalletActionStep · object | TVMTransactionWalletActionStep · object | ExternalTransactionWalletActionStep · object | CustodianTransactionWalletActionStep · object | TempoZoneSettlementWalletActionStep · object | WisdomTreeSettlementWalletActionStep · object)[]
The steps of the wallet action. Only returned if ?include=steps is provided.
A wallet action step consisting of an EVM transaction.
- EVMTransactionWalletActionStep
- EVMUserOperationWalletActionStep
- SVMTransactionWalletActionStep
- TVMTransactionWalletActionStep
- ExternalTransactionWalletActionStep
- CustodianTransactionWalletActionStep
- TempoZoneSettlementWalletActionStep
- WisdomTreeSettlementWalletActionStep
Show child attributes
Show child attributes
Estimated fee breakdown from the provider quote. Only present for cross-chain swaps. Populated after on-chain confirmation.
Estimated fee paid to the relayer.
- RelayerFee
- PrivyFee
- DeveloperFee
Show child attributes
Show child attributes
Example:
{
"type": "privy",
"recipient": "0x1234567890abcdef1234567890abcdef12345678",
"amount": "0.20"
}
Actual fees paid for the swap. Populated after on-chain confirmation. Only present for cross-chain swaps.
Estimated fee paid to the relayer.
- RelayerFee
- PrivyFee
- DeveloperFee
Show child attributes
Show child attributes
Example:
{
"type": "privy",
"recipient": "0x1234567890abcdef1234567890abcdef12345678",
"amount": "0.20"
}
Was this page helpful?

