External Wallets

Update an external wallet

patch/v1/external-wallets/{id}

Path parameters

idstring required

External wallet ID

Headers

X-API-Keystring

API key

Request body

chainsstring[]

Supported chains

currenciesstring[]

Supported currencies

Example request

{
  "chains": [
    "ETHEREUM",
    "BASE"
  ],
  "currencies": [
    "USDC",
    "USDT"
  ],
  "metadata": {
    "nickname": "Main Checking Account",
    "purpose": "Business operations",
    "tags": [
      "primary",
      "operations"
    ]
  }
}

Response

External wallet updated successfully

idstring required

Account ID

customerIdstring required

Customer ID

counterpartyIdstring nullable

Counterparty ID when this is a third-party recipient wallet

type'EXTERNAL_WALLET' required

Account type

status'IN_REVIEW' | 'ACTIVE' | 'CLOSED' required

Account status

walletAddressstring required

Wallet address

addressType'EVM' | 'TRON' | 'BITCOIN' | 'SOLANA' required

Wallet address type

chainsstring[]

Supported blockchain chains

Wallet custody type used for provider custodian mapping.

createdAtstring date-time required

Account creation date

updatedAtstring date-time required

Account last update date

createdboolean

Whether this account was newly created in this request or returned from an existing match

Example response

{
  "id": "ewa_1234567890abcdef",
  "customerId": "cust_abc123",
  "counterpartyId": "cp_abc123",
  "type": "EXTERNAL_WALLET",
  "status": "IN_REVIEW",
  "metadata": {
    "nickname": "Main Checking Account",
    "purpose": "Business operations",
    "tags": [
      "primary",
      "operations"
    ]
  },
  "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "addressType": "EVM",
  "chains": [
    "ETHEREUM",
    "BASE"
  ],
  "currencies": [
    [
      "USDC",
      "USDT"
    ]
  ],
  "custodyType": "SELF_HOSTED",
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-01-15T10:00:00Z",
  "created": true
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.