List Wallet Transfers

This is an unstable API that may change with time. The unstable prefix indicates that breaking changes may occur in future releases.

Overview

The List Wallet Transfers API allows you to retrieve the transfer history for a wallet, including both inbound and outbound token transfers. This endpoint supports multiple blockchains and provides cursor-based pagination for efficient data retrieval.

Prerequisites

You have a wallet created.
API Key: You have an API key with the scope: wallets:transactions.read. In staging, all scopes are included.

Retrieving Wallet Transfers

EVM Chains
Solana
Stellar

Get Ethereum Sepolia USDC Transfers

curl --request GET \
  --url 'https://staging.crossmint.com/api/unstable/wallets/WALLET_LOCATOR/transfers?chain=ethereum-sepolia&tokens=usdc&status=successful&limit=10' \
  --header 'X-API-KEY: YOUR_SERVER_API_KEY'

const url = "https://staging.crossmint.com/api/unstable/wallets/WALLET_LOCATOR/transfers";
const params = new URLSearchParams({
    chain: "ethereum-sepolia",
    tokens: "usdc",
    status: "successful",
    limit: "10"
});

const response = await fetch(`${url}?${params}`, {
    method: "GET",
    headers: {
        "X-API-KEY": "YOUR_SERVER_API_KEY"
    }
});

if (!response.ok) {
    throw new Error(`HTTP error: ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

url = "https://staging.crossmint.com/api/unstable/wallets/WALLET_LOCATOR/transfers"
params = {
    "chain": "ethereum-sepolia",
    "tokens": "usdc",
    "status": "successful",
    "limit": "10"
}
headers = {"X-API-KEY": "YOUR_SERVER_API_KEY"}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
data = response.json()
print(data)

Paginating Through Results

When your wallet has a lot of transactions, results are split into pages. Use the nextCursor value from each response in your next API call to get the next page of results.

async function getAllTransfers(walletLocator, chain, tokens) {
    const baseUrl = `https://staging.crossmint.com/api/unstable/wallets/${walletLocator}/transfers`;
    const allTransfers = [];
    let cursor = null;

    do {
        const params = new URLSearchParams({
            chain,
            tokens,
            status: "successful",
            limit: "30"
        });

        if (cursor) {
            params.set("cursor", cursor);
        }

        const response = await fetch(`${baseUrl}?${params}`, {
            headers: { "X-API-KEY": "YOUR_SERVER_API_KEY" }
        });

        if (!response.ok) {
            throw new Error(`HTTP error: ${response.status}`);
        }

        const result = await response.json();
        allTransfers.push(...result.data);
        cursor = result.nextCursor;
    } while (cursor);

    return allTransfers;
}

Get Solana USDC Transfers

curl --request GET \
  --url 'https://staging.crossmint.com/api/unstable/wallets/WALLET_LOCATOR/transfers?chain=solana&tokens=usdc&status=successful&limit=10' \
  --header 'X-API-KEY: YOUR_SERVER_API_KEY'

const url = "https://staging.crossmint.com/api/unstable/wallets/WALLET_LOCATOR/transfers";
const params = new URLSearchParams({
    chain: "solana",
    tokens: "usdc",
    status: "successful",
    limit: "10"
});

const response = await fetch(`${url}?${params}`, {
    method: "GET",
    headers: {
        "X-API-KEY": "YOUR_SERVER_API_KEY"
    }
});

if (!response.ok) {
    throw new Error(`HTTP error: ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

url = "https://staging.crossmint.com/api/unstable/wallets/WALLET_LOCATOR/transfers"
params = {
    "chain": "solana",
    "tokens": "usdc",
    "status": "successful",
    "limit": "10"
}
headers = {"X-API-KEY": "YOUR_SERVER_API_KEY"}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
data = response.json()
print(data)

Paginating Through Results

When your wallet has a lot of transactions, results are split into pages. Use the nextCursor value from each response in your next API call to get the next page of results.

async function getAllTransfers(walletLocator, chain, tokens) {
    const baseUrl = `https://staging.crossmint.com/api/unstable/wallets/${walletLocator}/transfers`;
    const allTransfers = [];
    let cursor = null;

    do {
        const params = new URLSearchParams({
            chain,
            tokens,
            status: "successful",
            limit: "30"
        });

        if (cursor) {
            params.set("cursor", cursor);
        }

        const response = await fetch(`${baseUrl}?${params}`, {
            headers: { "X-API-KEY": "YOUR_SERVER_API_KEY" }
        });

        if (!response.ok) {
            throw new Error(`HTTP error: ${response.status}`);
        }

        const result = await response.json();
        allTransfers.push(...result.data);
        cursor = result.nextCursor;
    } while (cursor);

    return allTransfers;
}

Get Stellar USDC Transfers

curl --request GET \
  --url 'https://staging.crossmint.com/api/unstable/wallets/STELLAR_WALLET_ADDRESS/transfers?chain=stellar&tokens=usdc&status=successful' \
  --header 'X-API-KEY: YOUR_SERVER_API_KEY'

const url = "https://staging.crossmint.com/api/unstable/wallets/STELLAR_WALLET_ADDRESS/transfers";
const params = new URLSearchParams({
    chain: "stellar",
    tokens: "usdc",
    status: "successful"
});

const response = await fetch(`${url}?${params}`, {
    method: "GET",
    headers: {
        "X-API-KEY": "YOUR_SERVER_API_KEY"
    }
});

if (!response.ok) {
    throw new Error(`HTTP error: ${response.status}`);
}

const data = await response.json();
console.log(data);

Paginating Through Results

When your wallet has a lot of transactions, results are split into pages. Use the nextCursor value from each response in your next API call to get the next page of results.

async function getAllTransfers(walletLocator, chain, tokens) {
    const baseUrl = `https://staging.crossmint.com/api/unstable/wallets/${walletLocator}/transfers`;
    const allTransfers = [];
    let cursor = null;

    do {
        const params = new URLSearchParams({
            chain,
            tokens,
            status: "successful",
            limit: "30"
        });

        if (cursor) {
            params.set("cursor", cursor);
        }

        const response = await fetch(`${baseUrl}?${params}`, {
            headers: { "X-API-KEY": "YOUR_SERVER_API_KEY" }
        });

        if (!response.ok) {
            throw new Error(`HTTP error: ${response.status}`);
        }

        const result = await response.json();
        allTransfers.push(...result.data);
        cursor = result.nextCursor;
    } while (cursor);

    return allTransfers;
}

API Reference

Two endpoints are available:

GET /unstable/wallets/{walletLocator}/transfers — Server-side API key authentication
GET /unstable/wallets/me:walletLocator/transfers — JWT authentication for the current user’s wallet

You can also use the SDK to retrieve transfers. The tokens and status filters are optional.

const transfers = await wallet.transfers({ tokens: "usdc", status: "successful" });

See the API reference for full parameter details and to test requests in the playground.

Important Notes

Chain Support

EVM chains: Fully supported. Results are cached for 10 minutes to improve performance.
Solana: Supported. Includes native SOL and SPL token transfers (e.g., USDC). Results are cached for 10 minutes.
Stellar: Supported for all Soroban and SEP-41 tokens.

EVM Limitations

Outgoing native-token transfers (e.g., ETH, MATIC) initiated by a smart wallet are only tracked on Ethereum, Polygon, and Ethereum Sepolia. On other EVM chains, these specific transfers won’t appear in the transfer history. This is unrelated to token support — ERC-20 transfers and incoming native-token transfers are tracked on every EVM chain; only outgoing smart-wallet-initiated native transfers are affected.

Pagination

Uses cursor-based pagination for efficient data retrieval
Supports bidirectional pagination with nextCursor and previousCursor
The cursor encodes the sort order, so you don’t need to re-specify it when paginating
Cached results expire after 10 minutes on EVM and Solana chains; refresh to load the latest data if the cursor expires

Timestamps

All timestamps are returned in ISO 8601 format (e.g., 2025-01-15T10:30:00.000Z).

Transfer Types

The API returns both inbound (wallets.transfer.in) and outbound (wallets.transfer.out) transfers. Transfers initiated through Crossmint include a transferId that can be used with the Get Transaction API.

Introduction

Quickstarts ⚡️

Concepts

Guides

API Reference

Overview

Prerequisites

Retrieving Wallet Transfers

Get Ethereum Sepolia USDC Transfers

Paginating Through Results

Get Solana USDC Transfers

Paginating Through Results

Get Stellar USDC Transfers

Paginating Through Results

API Reference

Important Notes

​Overview

​Prerequisites

​Retrieving Wallet Transfers

​Get Ethereum Sepolia USDC Transfers

​Paginating Through Results

​Get Solana USDC Transfers

​Paginating Through Results

​Get Stellar USDC Transfers

​Paginating Through Results

​API Reference

​Important Notes

Overview

Prerequisites

Retrieving Wallet Transfers

Get Ethereum Sepolia USDC Transfers

Paginating Through Results

Get Solana USDC Transfers

Paginating Through Results

Get Stellar USDC Transfers

Paginating Through Results

API Reference

Important Notes