Create an account

curl --request POST \
  --url https://api.platform.dakota.xyz/accounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "account_type": "onramp",
  "capabilities": [
    "ach",
    "fedwire"
  ],
  "rail": "ach",
  "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "destination_network_id": "ethereum-mainnet",
  "source_network_id": "ethereum-mainnet",
  "source_asset": "USDC",
  "destination_asset": "USDC",
  "return_address": {
    "network_id": "ethereum-mainnet",
    "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
  },
  "return_crypto_address": {
    "network_id": "ethereum-mainnet",
    "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
  },
  "developer_fee_bps": 50
}
'

const options = {
  method: 'POST',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    account_type: 'onramp',
    capabilities: ['ach', 'fedwire'],
    rail: 'ach',
    crypto_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    fiat_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    destination_network_id: 'ethereum-mainnet',
    source_network_id: 'ethereum-mainnet',
    source_asset: 'USDC',
    destination_asset: 'USDC',
    return_address: {
      network_id: 'ethereum-mainnet',
      crypto_address: '0x165cd37b4c644c2921454429e7f9358d18a45e14'
    },
    return_crypto_address: {
      network_id: 'ethereum-mainnet',
      crypto_address: '0x165cd37b4c644c2921454429e7f9358d18a45e14'
    },
    developer_fee_bps: 50
  })
};

fetch('https://api.platform.dakota.xyz/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/accounts"

payload = {
    "account_type": "onramp",
    "capabilities": ["ach", "fedwire"],
    "rail": "ach",
    "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_network_id": "ethereum-mainnet",
    "source_network_id": "ethereum-mainnet",
    "source_asset": "USDC",
    "destination_asset": "USDC",
    "return_address": {
        "network_id": "ethereum-mainnet",
        "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
    },
    "return_crypto_address": {
        "network_id": "ethereum-mainnet",
        "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
    },
    "developer_fee_bps": 50
}
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/accounts"

	payload := strings.NewReader("{\n  \"account_type\": \"onramp\",\n  \"capabilities\": [\n    \"ach\",\n    \"fedwire\"\n  ],\n  \"rail\": \"ach\",\n  \"crypto_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"fiat_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"destination_network_id\": \"ethereum-mainnet\",\n  \"source_network_id\": \"ethereum-mainnet\",\n  \"source_asset\": \"USDC\",\n  \"destination_asset\": \"USDC\",\n  \"return_address\": {\n    \"network_id\": \"ethereum-mainnet\",\n    \"crypto_address\": \"0x165cd37b4c644c2921454429e7f9358d18a45e14\"\n  },\n  \"return_crypto_address\": {\n    \"network_id\": \"ethereum-mainnet\",\n    \"crypto_address\": \"0x165cd37b4c644c2921454429e7f9358d18a45e14\"\n  },\n  \"developer_fee_bps\": 50\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",
  "account_type": "onramp",
  "bank_account": {
    "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "capabilities": [
      "ach",
      "fedwire"
    ],
    "aba_routing_number": "123456789",
    "aba_wire_routing_number": "123456789",
    "account_number": "123456789",
    "account_type": "checking",
    "bic": "DEUTDEFFXXX",
    "iban": "DE89370400440532013000",
    "account_holder_name": "John Doe",
    "account_holder_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "account_holder_phone": "1234567890",
    "bank_name": "Bank of America",
    "bank_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "bank_phone": "+12345678900"
  },
  "destination": {
    "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_type": "crypto",
    "name": "My Ethereum Wallet",
    "crypto_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "family": "evm",
    "network_id": "ethereum-mainnet"
  },
  "source_crypto_address": "0x1234",
  "source_family": "evm",
  "source_network_id": "ethereum-mainnet",
  "source_asset": "USDC",
  "destination_asset": "USDC",
  "rail": "ach",
  "destination_rail": "ach"
}

POST

accounts

Create an account

curl --request POST \
  --url https://api.platform.dakota.xyz/accounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "account_type": "onramp",
  "capabilities": [
    "ach",
    "fedwire"
  ],
  "rail": "ach",
  "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "destination_network_id": "ethereum-mainnet",
  "source_network_id": "ethereum-mainnet",
  "source_asset": "USDC",
  "destination_asset": "USDC",
  "return_address": {
    "network_id": "ethereum-mainnet",
    "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
  },
  "return_crypto_address": {
    "network_id": "ethereum-mainnet",
    "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
  },
  "developer_fee_bps": 50
}
'

const options = {
  method: 'POST',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    account_type: 'onramp',
    capabilities: ['ach', 'fedwire'],
    rail: 'ach',
    crypto_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    fiat_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    destination_network_id: 'ethereum-mainnet',
    source_network_id: 'ethereum-mainnet',
    source_asset: 'USDC',
    destination_asset: 'USDC',
    return_address: {
      network_id: 'ethereum-mainnet',
      crypto_address: '0x165cd37b4c644c2921454429e7f9358d18a45e14'
    },
    return_crypto_address: {
      network_id: 'ethereum-mainnet',
      crypto_address: '0x165cd37b4c644c2921454429e7f9358d18a45e14'
    },
    developer_fee_bps: 50
  })
};

fetch('https://api.platform.dakota.xyz/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/accounts"

payload = {
    "account_type": "onramp",
    "capabilities": ["ach", "fedwire"],
    "rail": "ach",
    "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_network_id": "ethereum-mainnet",
    "source_network_id": "ethereum-mainnet",
    "source_asset": "USDC",
    "destination_asset": "USDC",
    "return_address": {
        "network_id": "ethereum-mainnet",
        "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
    },
    "return_crypto_address": {
        "network_id": "ethereum-mainnet",
        "crypto_address": "0x165cd37b4c644c2921454429e7f9358d18a45e14"
    },
    "developer_fee_bps": 50
}
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/accounts"

	payload := strings.NewReader("{\n  \"account_type\": \"onramp\",\n  \"capabilities\": [\n    \"ach\",\n    \"fedwire\"\n  ],\n  \"rail\": \"ach\",\n  \"crypto_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"fiat_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"destination_network_id\": \"ethereum-mainnet\",\n  \"source_network_id\": \"ethereum-mainnet\",\n  \"source_asset\": \"USDC\",\n  \"destination_asset\": \"USDC\",\n  \"return_address\": {\n    \"network_id\": \"ethereum-mainnet\",\n    \"crypto_address\": \"0x165cd37b4c644c2921454429e7f9358d18a45e14\"\n  },\n  \"return_crypto_address\": {\n    \"network_id\": \"ethereum-mainnet\",\n    \"crypto_address\": \"0x165cd37b4c644c2921454429e7f9358d18a45e14\"\n  },\n  \"developer_fee_bps\": 50\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",
  "account_type": "onramp",
  "bank_account": {
    "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "capabilities": [
      "ach",
      "fedwire"
    ],
    "aba_routing_number": "123456789",
    "aba_wire_routing_number": "123456789",
    "account_number": "123456789",
    "account_type": "checking",
    "bic": "DEUTDEFFXXX",
    "iban": "DE89370400440532013000",
    "account_holder_name": "John Doe",
    "account_holder_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "account_holder_phone": "1234567890",
    "bank_name": "Bank of America",
    "bank_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "bank_phone": "+12345678900"
  },
  "destination": {
    "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_type": "crypto",
    "name": "My Ethereum Wallet",
    "crypto_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "family": "evm",
    "network_id": "ethereum-mainnet"
  },
  "source_crypto_address": "0x1234",
  "source_family": "evm",
  "source_network_id": "ethereum-mainnet",
  "source_asset": "USDC",
  "destination_asset": "USDC",
  "rail": "ach",
  "destination_rail": "ach"
}

Authorizations

x-api-key

string

header

required

Headers

x-idempotency-key

string<uuid>

required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

X-Sandbox-Scenario

enum<string>

Sandbox-only. Applies a preset failure or behavior mode for the request, selecting a coherent combination of error step, status, and message. The full set of scenarios is also exposed dynamically via GET /sandbox/scenarios along with descriptions and per-rail applicability. Effective only on https://api.platform.sandbox.dakota.xyz. Ignored in production.

Available options:

happy_path,

delayed_settlement,

insufficient_funds,

compliance_block,

invalid_account,

provider_maintenance,

network_congestion,

kyb_manual_review,

kyb_rejected,

kyb_expired,

network_timeout,

intermittent_errors,

account_frozen,

document_expired,

invalid_swift

Example:

"insufficient_funds"

X-Sandbox-Error-Step

enum<string>

Sandbox-only. Names the pipeline step at which the injected error fires. Pair with X-Sandbox-Error-Status and (optionally) X-Sandbox-Error-Message to drive a deterministic failure mode at a known point in the request lifecycle. Values longer than 100 characters are ignored. Effective only on https://api.platform.sandbox.dakota.xyz. Ignored in production.

Available options:

transaction_processing,

compliance_check,

account_validation,

provider_call,

kyb_submission,

kyb_approval,

network_call

Maximum string length: 100

Example:

"provider_call"

X-Sandbox-Error-Status

integer

Sandbox-only. Sets the HTTP status code returned when the sandbox injects an error at the configured step (see X-Sandbox-Error-Step). Must be a valid HTTP status code in the range 100-599; values outside that range are ignored. Status codes >= 400 cause the request to short-circuit immediately with a structured error response. Effective only on https://api.platform.sandbox.dakota.xyz. Ignored in production.

Required range: 100 <= x <= 599

Example:

503

X-Sandbox-Error-Message

string

Sandbox-only. Sets the human-readable message field of the injected sandbox error response. Truncated values longer than 500 characters are ignored. Effective only on https://api.platform.sandbox.dakota.xyz. Ignored in production.

Maximum string length: 500

Example:

"Provider temporarily unavailable for maintenance."

Body

application/json

Unified account create request for onramp/offramp/swap.

account_type

enum<string>

required

Unified account family for account resources.

Available options:

onramp,

offramp,

swap

Example:

"onramp"

capabilities

enum<string>[]

List of payment capabilities supported by a rail. Currently, as input, you can only request one in this list. This constraint will be loosened in the future.

Minimum array length: 1

Type of payment rail capability supported. For onramp accounts, us_bank_account indicates the account accepts both ACH and Wire (Fedwire) deposits interchangeably.

Available options:

ach,

fedwire,

swift,

us_bank_account

Example:

["ach", "fedwire"]

rail

enum<string>

Type of payment rail capability supported. For onramp accounts, us_bank_account indicates the account accepts both ACH and Wire (Fedwire) deposits interchangeably.

Available options:

ach,

fedwire,

swift,

us_bank_account

Example:

"ach"

crypto_destination_id

string

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

fiat_destination_id

string

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

destination_network_id

enum<string>

Identifier for a blockchain network

Available options:

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

Required string length: 1 - 30

Example:

"ethereum-mainnet"

source_network_id

string

Source network ID or wildcard network for crypto input.

Example:

"ethereum-mainnet"

source_asset

string

Asset to send into the account.

Minimum string length: 1

Example:

"USDC"

destination_asset

string

Asset to receive at the destination.

Minimum string length: 1

Example:

"USDC"

return_address

Crypto Resource Identifier · object

A unique identifier for a specific account on a specific blockchain. When rendered as a string, it has the syntax: :// (e.g., ethereum-mainnet://0x165cd37b4c644c2921454429e7f9358d18a45e14)

Show child attributes

return_crypto_address

Crypto Resource Identifier · object

A unique identifier for a specific account on a specific blockchain. When rendered as a string, it has the syntax: :// (e.g., ethereum-mainnet://0x165cd37b4c644c2921454429e7f9358d18a45e14)

Show child attributes

developer_fee_bps

integer<int32>

Developer fee in basis points (1 bp = 0.01%).

Required range: 0 <= x <= 10000

Example:

50

Response

Account created successfully.

Unified account response for onramp/offramp/swap.

string

required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

account_type

enum<string>

required

Unified account family for account resources.

Available options:

onramp,

offramp,

swap

Example:

"onramp"

bank_account

Bank Account · object

Unified schema for bank accounts.

Show child attributes

destination

Crypto Destination Response · object

Response for a crypto destination.

Crypto Destination Response
Crypto Destination Response
Crypto Destination Response
US Fiat Destination Response
IBAN Fiat Destination Response

Show child attributes

source_crypto_address

string

Source crypto address for offramp/swap accounts.

Example:

"0x1234"

source_family

enum<string>

Blockchain family for the crypto account.

Available options:

evm,

solana

Example:

"evm"

source_network_id

enum<string>

Identifier for a blockchain network

Available options:

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

Required string length: 1 - 30

Example:

"ethereum-mainnet"

source_asset

string

Asset sent into the account.

Example:

"USDC"

destination_asset

string

Asset received at the destination.

Example:

"USDC"

rail

enum<string>

Type of payment rail capability supported. For onramp accounts, us_bank_account indicates the account accepts both ACH and Wire (Fedwire) deposits interchangeably.

Available options:

ach,

fedwire,

swift,

us_bank_account

Example:

"ach"

destination_rail

enum<string>

Type of payment rail capability supported. For onramp accounts, us_bank_account indicates the account accepts both ACH and Wire (Fedwire) deposits interchangeably.

Available options:

ach,

fedwire,

swift,

us_bank_account

Example:

"ach"

List accounts Get an account

⌘I

API documentation

Customers

Wallets

Transactions

Recipients

Accounts

Auto Transactions

Onboarding

Policies

Signer Groups

Authentication

Users

Webhooks

Events

Info

Sandbox

Self Serve

Agentic Payments

Mandates

Insights

Payouts

Create an account

Authorizations

Headers

Body

Response