curl --request POST \
--url https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"signatures": [
"LS0tLS1CRUdJ...0tLS0tCg=="
],
"intent": {
"wallet_id": "string",
"caip2": "string",
"operation": {
"kind": "string",
"from": "string",
"to": "string",
"amount": "100.50",
"asset_id": "USDC",
"method": "string",
"args": [
"string"
],
"data": "string"
},
"idempotency_key": "string"
}
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
signatures: ['LS0tLS1CRUdJ...0tLS0tCg=='],
intent: {
wallet_id: 'string',
caip2: 'string',
operation: {
kind: 'string',
from: 'string',
to: 'string',
amount: '100.50',
asset_id: 'USDC',
method: 'string',
args: ['string'],
data: 'string'
},
idempotency_key: 'string'
}
})
};
fetch('https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions"
payload = {
"signatures": ["LS0tLS1CRUdJ...0tLS0tCg=="],
"intent": {
"wallet_id": "string",
"caip2": "string",
"operation": {
"kind": "string",
"from": "string",
"to": "string",
"amount": "100.50",
"asset_id": "USDC",
"method": "string",
"args": ["string"],
"data": "string"
},
"idempotency_key": "string"
}
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions"
payload := strings.NewReader("{\n \"signatures\": [\n \"LS0tLS1CRUdJ...0tLS0tCg==\"\n ],\n \"intent\": {\n \"wallet_id\": \"string\",\n \"caip2\": \"string\",\n \"operation\": {\n \"kind\": \"string\",\n \"from\": \"string\",\n \"to\": \"string\",\n \"amount\": \"100.50\",\n \"asset_id\": \"USDC\",\n \"method\": \"string\",\n \"args\": [\n \"string\"\n ],\n \"data\": \"string\"\n },\n \"idempotency_key\": \"string\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
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": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"resource_type": "wallet",
"wallet_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"network_id": "ethereum-mainnet",
"from": "0x1234567890abcdef1234567890abcdef12345678",
"to": "0xabcdef1234567890abcdef1234567890abcdef12",
"transaction_hash": "0x165cd37b4c644c2921454429e7f9358d18a45e14",
"transaction_type": "transfer",
"amount": "100.56",
"asset": "USD",
"status": "Waiting For Signature",
"status_code": "waiting_for_signature"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
"title": "Bad request - invalid input data",
"status": 400,
"detail": "Bad request - invalid input data",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
"title": "Unauthorized",
"status": 401,
"detail": "Unauthorized",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
"title": "Forbidden",
"status": 403,
"detail": "Forbidden",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Not Found",
"status": 404,
"detail": "Not Found",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#conflict",
"title": "Conflict - duplicate request detected",
"status": 409,
"detail": "Conflict - duplicate request detected",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
"title": "Internal server error",
"status": 500,
"detail": "Internal server error",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#wallet-send-indeterminate",
"title": "Wallet Send Outcome Indeterminate",
"status": 502,
"detail": "The wallet provider did not confirm whether this transaction was sent. Treat the outcome as unknown, not failed: check the transaction's status before retrying, and never resubmit under a new idempotency key.",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
"title": "Service unavailable",
"status": 503,
"detail": "Service unavailable",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
"title": "Unexpected error",
"status": 500,
"detail": "Unexpected error",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}Send a transaction from a wallet
Creates a new outbound transaction from the specified wallet. Policy and signer checks may affect the resulting transaction state.
curl --request POST \
--url https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"signatures": [
"LS0tLS1CRUdJ...0tLS0tCg=="
],
"intent": {
"wallet_id": "string",
"caip2": "string",
"operation": {
"kind": "string",
"from": "string",
"to": "string",
"amount": "100.50",
"asset_id": "USDC",
"method": "string",
"args": [
"string"
],
"data": "string"
},
"idempotency_key": "string"
}
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
signatures: ['LS0tLS1CRUdJ...0tLS0tCg=='],
intent: {
wallet_id: 'string',
caip2: 'string',
operation: {
kind: 'string',
from: 'string',
to: 'string',
amount: '100.50',
asset_id: 'USDC',
method: 'string',
args: ['string'],
data: 'string'
},
idempotency_key: 'string'
}
})
};
fetch('https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions"
payload = {
"signatures": ["LS0tLS1CRUdJ...0tLS0tCg=="],
"intent": {
"wallet_id": "string",
"caip2": "string",
"operation": {
"kind": "string",
"from": "string",
"to": "string",
"amount": "100.50",
"asset_id": "USDC",
"method": "string",
"args": ["string"],
"data": "string"
},
"idempotency_key": "string"
}
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/wallets/{wallet_id}/transactions"
payload := strings.NewReader("{\n \"signatures\": [\n \"LS0tLS1CRUdJ...0tLS0tCg==\"\n ],\n \"intent\": {\n \"wallet_id\": \"string\",\n \"caip2\": \"string\",\n \"operation\": {\n \"kind\": \"string\",\n \"from\": \"string\",\n \"to\": \"string\",\n \"amount\": \"100.50\",\n \"asset_id\": \"USDC\",\n \"method\": \"string\",\n \"args\": [\n \"string\"\n ],\n \"data\": \"string\"\n },\n \"idempotency_key\": \"string\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
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": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"resource_type": "wallet",
"wallet_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
"network_id": "ethereum-mainnet",
"from": "0x1234567890abcdef1234567890abcdef12345678",
"to": "0xabcdef1234567890abcdef1234567890abcdef12",
"transaction_hash": "0x165cd37b4c644c2921454429e7f9358d18a45e14",
"transaction_type": "transfer",
"amount": "100.56",
"asset": "USD",
"status": "Waiting For Signature",
"status_code": "waiting_for_signature"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
"title": "Bad request - invalid input data",
"status": 400,
"detail": "Bad request - invalid input data",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
"title": "Unauthorized",
"status": 401,
"detail": "Unauthorized",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
"title": "Forbidden",
"status": 403,
"detail": "Forbidden",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Not Found",
"status": 404,
"detail": "Not Found",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#conflict",
"title": "Conflict - duplicate request detected",
"status": 409,
"detail": "Conflict - duplicate request detected",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
"title": "Internal server error",
"status": 500,
"detail": "Internal server error",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#wallet-send-indeterminate",
"title": "Wallet Send Outcome Indeterminate",
"status": 502,
"detail": "The wallet provider did not confirm whether this transaction was sent. Treat the outcome as unknown, not failed: check the transaction's status before retrying, and never resubmit under a new idempotency key.",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
"title": "Service unavailable",
"status": 503,
"detail": "Service unavailable",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
"title": "Unexpected error",
"status": 500,
"detail": "Unexpected error",
"instance": "https://api.platform.dakota.xyz/wallets/example-id/transactions",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}Headers
Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.
A key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a
successful (below 400) response. Repeating the same request (same JSON body, whatever the key order or
whitespace) with the same key within that window returns the original response with
X-Idempotent-Replayed: true instead of executing the request again. Using the same key on the same
endpoint with a different body returns 422 with problem type idempotency-key-reused; the request is
not executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason
can be corrected and retried under the same key. Request bodies that are not JSON (for example file
uploads) are not compared.
Path Parameters
Body
List of signatures over the intent
Cryptographic signature over the intent, base64-encoded. For an ES256 signer this is the ASN.1 DER ECDSA signature over the SHA-256 of the canonical intent. For a WEBAUTHN signer this is the base64 of the WebAuthn assertion JSON (id, rawId, type, and response.authenticatorData / clientDataJSON / signature). See the WebAuthn & Passkey Signing guide.
Response
Transaction accepted. A new send is returned at waiting_for_signature and reaches broadcasted and its outcome through wallet.transaction.updated webhooks. Repeating a send with an intent idempotency_key this wallet already used returns the existing transaction in its current status.
A transaction sent from a crypto wallet: a transfer of funds, or a contract call (transaction_type evm_contract_call), which carries no amount and no asset.
Current status of a transaction.
Auto-account transactions (GET /auto-transactions and the transaction.auto.* events) return the snake_case values.
Wallet transactions, the wallet.transaction.* events and the auto-account transactions listed by GET /transactions (the WalletTransaction, Transaction, NestedTransaction, FXPageKnownTransaction and FXTransaction objects) return a display label such as Waiting For Signature or Success, meant for showing to people. Branch on their status_code instead.
canceled is a legacy spelling and is never returned.
timed_out, not_started, in_progress, awaiting_confirmation, pending, processing, completed, invalid, failed, cancelled, canceled, reversed, rejected, broadcasted, pending_return, returned, pending_reversal, paused_credits, Timed Out, Not Started, In Progress, Awaiting Confirmation, Success, Invalid, Failed, Cancelled, Reversed, Rejected, Needs Manual Input, Waiting For Signature, Broadcasted, Pending Return, Returned, Pending Reversal, Unknown Machine-readable status. Branch on this value; status is its display label.
not_started, in_progress, waiting_for_signature, broadcasted, awaiting_confirmation, needs_manual_input, timed_out, pending_return, pending_reversal, completed, failed, invalid, cancelled, reversed, rejected, returned, unknown "completed"
Identifier for a blockchain network
ethereum-mainnet, ethereum-sepolia, ethereum-goerli, ethereum-holesky, solana-mainnet, solana-devnet, solana-testnet, base-mainnet, base-sepolia, arbitrum-mainnet, arbitrum-sepolia, optimism-mainnet, optimism-sepolia, polygon-mainnet, polygon-amoy 1 - 30"ethereum-mainnet"
Was this page helpful?

