Sign in

v1

latestOpenAPI 3.0.12026-07-2699111970.1 KB

Transfer Token

Sends a token of any type from this wallet to a recipient

post/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
  • userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
  • phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
  • twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
  • chainType[:<walletType>]:alias:<alias>
tokenLocatorstring required

A token locator that supports native tokens, fungible tokens, and NFTs across different chains. It can be of the format:

  • chain:address[:tokenId]
  • chain:currency
  • chain:address

Headers

X-API-KEYstring required

API key required for authentication

x-idempotency-keystring

Unique key to prevent duplicate transaction creation

Request body

OR

Example request

{
  "signer": "external-wallet:0xdeadbeef",
  "amount": "42.69"
}

Response

The transaction has been successfully created.

OR
OR
OR
OR

Example response

{
  "error": {
    "revert": {
      "type": "contract_call",
      "reason": "ERC20: transfer amount exceeds balance"
    }
  }
}