Transfer Token

curl --request POST \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "amount": "42.69",
  "recipient": "CROSSMINT",
  "memo": {
    "type": "text",
    "value": "Hello, world!"
  },
  "signer": "external-wallet:0xdeadbeef",
  "transactionType": "direct"
}
'

import requests

url = "https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers"

payload = {
    "amount": "42.69",
    "recipient": "CROSSMINT",
    "memo": {
        "type": "text",
        "value": "Hello, world!"
    },
    "signer": "external-wallet:0xdeadbeef",
    "transactionType": "direct"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: '42.69',
    recipient: 'CROSSMINT',
    memo: {type: 'text', value: 'Hello, world!'},
    signer: 'external-wallet:0xdeadbeef',
    transactionType: 'direct'
  })
};

fetch('https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => '42.69',
    'recipient' => 'CROSSMINT',
    'memo' => [
        'type' => 'text',
        'value' => 'Hello, world!'
    ],
    'signer' => 'external-wallet:0xdeadbeef',
    'transactionType' => 'direct'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers"

	payload := strings.NewReader("{\n  \"amount\": \"42.69\",\n  \"recipient\": \"CROSSMINT\",\n  \"memo\": {\n    \"type\": \"text\",\n    \"value\": \"Hello, world!\"\n  },\n  \"signer\": \"external-wallet:0xdeadbeef\",\n  \"transactionType\": \"direct\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-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))

}

HttpResponse<String> response = Unirest.post("https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers")
  .header("X-API-KEY", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"42.69\",\n  \"recipient\": \"CROSSMINT\",\n  \"memo\": {\n    \"type\": \"text\",\n    \"value\": \"Hello, world!\"\n  },\n  \"signer\": \"external-wallet:0xdeadbeef\",\n  \"transactionType\": \"direct\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"42.69\",\n  \"recipient\": \"CROSSMINT\",\n  \"memo\": {\n    \"type\": \"text\",\n    \"value\": \"Hello, world!\"\n  },\n  \"signer\": \"external-wallet:0xdeadbeef\",\n  \"transactionType\": \"direct\"\n}"

response = http.request(request)
puts response.read_body

{
  "chainType": "aptos",
  "createdAt": 123,
  "id": "<string>",
  "onChain": {
    "call": {
      "data": "<unknown>",
      "to": "<string>"
    },
    "explorerLink": "<string>",
    "txId": "<string>"
  },
  "params": {
    "call": {
      "abi": [
        "<unknown>"
      ],
      "address": "<string>",
      "args": [
        "<unknown>"
      ],
      "functionName": "<string>"
    },
    "chain": "abstract"
  },
  "status": "awaiting-approval",
  "walletType": "mpc",
  "approvals": {
    "pending": [
      {
        "quorumApprovals": {
          "pending": [
            {
              "message": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              }
            }
          ],
          "remaining": 123,
          "submitted": [
            {
              "message": "<string>",
              "signature": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              },
              "submittedAt": 123
            }
          ],
          "threshold": 123
        },
        "signer": {
          "locator": "<string>",
          "type": "quorum"
        }
      }
    ],
    "submitted": [
      {
        "quorumApprovals": {
          "pending": [
            {
              "message": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              }
            }
          ],
          "remaining": 123,
          "submitted": [
            {
              "message": "<string>",
              "signature": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              },
              "submittedAt": 123
            }
          ],
          "threshold": 123
        },
        "signer": {
          "locator": "<string>",
          "type": "quorum"
        }
      }
    ],
    "required": 123
  },
  "completedAt": 123,
  "error": {
    "message": "<string>",
    "reason": "program_error",
    "logs": "<unknown>",
    "revertData": {}
  },
  "fees": {
    "mode": "project",
    "actual": "<unknown>",
    "billed": {
      "usd": 123
    },
    "billing": {
      "status": "failed"
    },
    "estimate": "<unknown>"
  },
  "sendParams": {
    "params": {
      "recipient": "<string>",
      "recipientAddress": "<string>",
      "amount": "<string>"
    },
    "token": "<string>"
  }
}

POST

2025-06-09

wallets

{walletLocator}

tokens

{tokenLocator}

transfers

Transfer Token

curl --request POST \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "amount": "42.69",
  "recipient": "CROSSMINT",
  "memo": {
    "type": "text",
    "value": "Hello, world!"
  },
  "signer": "external-wallet:0xdeadbeef",
  "transactionType": "direct"
}
'

import requests

url = "https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers"

payload = {
    "amount": "42.69",
    "recipient": "CROSSMINT",
    "memo": {
        "type": "text",
        "value": "Hello, world!"
    },
    "signer": "external-wallet:0xdeadbeef",
    "transactionType": "direct"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: '42.69',
    recipient: 'CROSSMINT',
    memo: {type: 'text', value: 'Hello, world!'},
    signer: 'external-wallet:0xdeadbeef',
    transactionType: 'direct'
  })
};

fetch('https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => '42.69',
    'recipient' => 'CROSSMINT',
    'memo' => [
        'type' => 'text',
        'value' => 'Hello, world!'
    ],
    'signer' => 'external-wallet:0xdeadbeef',
    'transactionType' => 'direct'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers"

	payload := strings.NewReader("{\n  \"amount\": \"42.69\",\n  \"recipient\": \"CROSSMINT\",\n  \"memo\": {\n    \"type\": \"text\",\n    \"value\": \"Hello, world!\"\n  },\n  \"signer\": \"external-wallet:0xdeadbeef\",\n  \"transactionType\": \"direct\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-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))

}

HttpResponse<String> response = Unirest.post("https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers")
  .header("X-API-KEY", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"42.69\",\n  \"recipient\": \"CROSSMINT\",\n  \"memo\": {\n    \"type\": \"text\",\n    \"value\": \"Hello, world!\"\n  },\n  \"signer\": \"external-wallet:0xdeadbeef\",\n  \"transactionType\": \"direct\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/tokens/{tokenLocator}/transfers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"42.69\",\n  \"recipient\": \"CROSSMINT\",\n  \"memo\": {\n    \"type\": \"text\",\n    \"value\": \"Hello, world!\"\n  },\n  \"signer\": \"external-wallet:0xdeadbeef\",\n  \"transactionType\": \"direct\"\n}"

response = http.request(request)
puts response.read_body

{
  "chainType": "aptos",
  "createdAt": 123,
  "id": "<string>",
  "onChain": {
    "call": {
      "data": "<unknown>",
      "to": "<string>"
    },
    "explorerLink": "<string>",
    "txId": "<string>"
  },
  "params": {
    "call": {
      "abi": [
        "<unknown>"
      ],
      "address": "<string>",
      "args": [
        "<unknown>"
      ],
      "functionName": "<string>"
    },
    "chain": "abstract"
  },
  "status": "awaiting-approval",
  "walletType": "mpc",
  "approvals": {
    "pending": [
      {
        "quorumApprovals": {
          "pending": [
            {
              "message": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              }
            }
          ],
          "remaining": 123,
          "submitted": [
            {
              "message": "<string>",
              "signature": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              },
              "submittedAt": 123
            }
          ],
          "threshold": 123
        },
        "signer": {
          "locator": "<string>",
          "type": "quorum"
        }
      }
    ],
    "submitted": [
      {
        "quorumApprovals": {
          "pending": [
            {
              "message": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              }
            }
          ],
          "remaining": 123,
          "submitted": [
            {
              "message": "<string>",
              "signature": "<string>",
              "signer": {
                "address": "<string>",
                "locator": "<string>",
                "type": "api-key"
              },
              "submittedAt": 123
            }
          ],
          "threshold": 123
        },
        "signer": {
          "locator": "<string>",
          "type": "quorum"
        }
      }
    ],
    "required": 123
  },
  "completedAt": 123,
  "error": {
    "message": "<string>",
    "reason": "program_error",
    "logs": "<unknown>",
    "revertData": {}
  },
  "fees": {
    "mode": "project",
    "actual": "<unknown>",
    "billed": {
      "usd": 123
    },
    "billing": {
      "status": "failed"
    },
    "estimate": "<unknown>"
  },
  "sendParams": {
    "params": {
      "recipient": "<string>",
      "recipientAddress": "<string>",
      "amount": "<string>"
    },
    "token": "<string>"
  }
}

Headers

X-API-KEY

string

required

API key required for authentication

x-idempotency-key

string

Unique key to prevent duplicate transaction creation

Path Parameters

walletLocator

string

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>

tokenLocator

string

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

Body

application/json

Option 1
Option 2

Base fields for all token deposits

amount

string

required

Amount of tokens to transfer (in decimal value)

Pattern: ^\d+(?:\.\d*)?$

Example:

"42.69"

recipient

string

required

Example:

"CROSSMINT"

fees

object

Optional per-transaction fee configuration override. When omitted, the project default is used.

Show child attributes

memo

object

Memo for the transaction. Only supported for Stellar

Option 1
Option 2
Option 3

Show child attributes

Example:

{ "type": "text", "value": "Hello, world!" }

signer

string

Optional signer locator. Defaults to admin signer

Example:

"external-wallet:0xdeadbeef"

transactionType

default:direct

Specifies the type of transaction. Choose 'direct' for standard interactions or 'regulated-transfer' for operations requiring compliance checks.

Available options:

direct

Response

201 - application/json

The transaction has been successfully created.

EVM MPC Wallet
EVM Smart Wallet
Stellar Smart Wallet
Solana Smart Wallet
Solana MPC Wallet

Complete transaction response including status, signing requirements, and wallet type specific data

chainType

enum<string>

required

The blockchain type of the wallet

Available options:

aptos,

evm,

solana,

stellar,

sui

createdAt

required

ISO timestamp when the transaction was created

string

required

Unique identifier for the transaction

onChain

EVM MPC wallet transaction data · object

required

Transaction data specific to EVM MPC wallets

Show child attributes

params

object

required

Show child attributes

status

enum<string>

required

Current status of the transaction

Available options:

awaiting-approval,

failed,

pending,

success

walletType

enum<string>

required

The wallet type (smart or mpc)

Available options:

mpc,

smart

approvals

object

Complete approval data including requirements, pending and submitted signatures

Show child attributes

completedAt

ISO timestamp when the transaction reached finality

error

object

Error message if the transaction fails after submission

Option 1
Option 2
Option 3

Show child attributes

fees

object

Transaction fee information including actual transaction fees, billed amounts, and billing status

Show child attributes

sendParams

object

Show child attributes

Introduction

Quickstarts ⚡️

Concepts

Guides

API Reference

Transfer Token

Headers

Path Parameters

Body

Response