Register or replace your fee payout destination

curl --request PUT \
  --url https://api.platform.dakota.xyz/fee-payout-destination \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "usdc_wallet": {
    "chain": "eip155:8453",
    "address": "0x1234567890123456789012345678901234567890"
  }
}
'

{
  "type": "usdc_wallet",
  "chain": "eip155:8453",
  "wallet_address": "0x1234567890123456789012345678901234567890",
  "updated_at": "2026-06-30T12:00:00Z"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#validation-error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request body validation failed - missing required field 'address'",
  "instance": "https://api.platform.dakota.xyz/fee-payout-destination",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
  "errors": [
    {
      "field": "address",
      "message": "Request body validation failed - missing required field 'address'",
      "code": "missing_required_field"
    }
  ]
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/fee-payout-destination",
  "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/fee-payout-destination",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "Validation failed",
  "instance": "https://api.platform.dakota.xyz/fee-payout-destination",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
  "errors": [
    {
      "field": "usdc_wallet.chain",
      "message": "chain is not a supported USDC network"
    }
  ]
}

PUT

fee-payout-destination

curl --request PUT \
  --url https://api.platform.dakota.xyz/fee-payout-destination \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "usdc_wallet": {
    "chain": "eip155:8453",
    "address": "0x1234567890123456789012345678901234567890"
  }
}
'

{
  "type": "usdc_wallet",
  "chain": "eip155:8453",
  "wallet_address": "0x1234567890123456789012345678901234567890",
  "updated_at": "2026-06-30T12:00:00Z"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#validation-error",
  "title": "Validation Error",
  "status": 400,
  "detail": "Request body validation failed - missing required field 'address'",
  "instance": "https://api.platform.dakota.xyz/fee-payout-destination",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
  "errors": [
    {
      "field": "address",
      "message": "Request body validation failed - missing required field 'address'",
      "code": "missing_required_field"
    }
  ]
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Unauthorized",
  "instance": "https://api.platform.dakota.xyz/fee-payout-destination",
  "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/fee-payout-destination",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "Validation failed",
  "instance": "https://api.platform.dakota.xyz/fee-payout-destination",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6",
  "errors": [
    {
      "field": "usdc_wallet.chain",
      "message": "chain is not a supported USDC network"
    }
  ]
}

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.

Body

application/json

Option 1
Option 2

Exactly one of usdc_wallet or us_bank_account must be set.

usdc_wallet

object

required

Show child attributes

us_bank_account

object

Show child attributes

Response

Destination registered.

A client's registered destination for developer-fee payouts.

type

enum<string>

required

Available options:

usdc_wallet,

us_bank_account

updated_at

string<date-time>

required

chain

string

CAIP-2 chain id. Present when type is usdc_wallet.

Example:

"eip155:8453"

wallet_address

string

Present when type is usdc_wallet.

account_holder_name

string

Present when type is us_bank_account.

routing_number

string

Present when type is us_bank_account.

account_number_last4

string

Last 4 digits only; full numbers are never returned. Present when type is us_bank_account.

bank_account_type

enum<string>

Present when type is us_bank_account.

Available options:

checking,

savings

Get your fee payout destination Remove your fee payout destination

⌘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

Register or replace your fee payout destination

Authorizations

Headers

Body

Response