Skip to main content
GET
/
unstable
/
wallets
/
{walletLocator}
/
transfers
Get Wallet Activity (Unstable)
curl --request GET \
  --url https://staging.crossmint.com/api/unstable/wallets/{walletLocator}/transfers \
  --header 'X-API-KEY: <x-api-key>'
{
  "data": [
    {
      "sender": {
        "address": "0x1234567890123456789012345678901234567890",
        "chain": "ethereum",
        "locator": "ethereum:0x1234567890123456789012345678901234567890",
        "owner": "user-123"
      },
      "recipient": {
        "address": "0x1234567890123456789012345678901234567890",
        "chain": "ethereum",
        "locator": "ethereum:0x1234567890123456789012345678901234567890",
        "owner": "user-123"
      },
      "token": {
        "type": "fungible",
        "chain": "ethereum",
        "locator": "ethereum:0x123",
        "amount": "18.833423432423",
        "rawAmount": "18834161225104097789",
        "contractAddress": "0x123",
        "decimals": 6
      },
      "status": "succeeded",
      "completedAt": "2025-10-21T12:34:56.789Z",
      "onChain": {
        "txId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "explorerLink": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      },
      "type": "wallets.transfer.in",
      "transferId": "93fd7f08-0c63-4d73-808b-6268e665c964"
    }
  ],
  "nextCursor": "<string>",
  "previousCursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Headers

​
X-API-KEY
string
required

API key required for authentication

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>

Query Parameters

​
cursor
string
​
limit
string
default:30
​
sort
enum<string>
default:desc
Available options:
asc,
desc
​
chain
enum<string>
required

The blockchain network to query. Either an EVM chain, Solana, or Stellar.

Available options:
arbitrum-sepolia,
arc-testnet,
avalanche-fuji,
curtis,
base-goerli,
base-sepolia,
bsc-testnet,
chiliz-spicy-testnet,
coti-testnet,
ethereum-goerli,
ethereum-sepolia,
hedera-testnet,
hypersonic-testnet,
lightlink-pegasus,
mantle-sepolia,
optimism-goerli,
optimism-sepolia,
polygon-amoy,
polygon-mumbai,
crossmint-private-testnet-ethereum,
crossmint-private-testnet-polygon,
rari-testnet,
scroll-sepolia,
sei-atlantic-2-testnet,
shape-sepolia,
skale-nebula-testnet,
soneium-minato-testnet,
space-testnet,
story-testnet,
verify-testnet,
viction-testnet,
xai-sepolia-testnet,
zkatana,
zkyoto,
zora-goerli,
zora-sepolia,
mode-sepolia,
u2u-nebulas,
zenchain-testnet,
abstract-testnet,
world-chain-sepolia,
plume-testnet,
flow-testnet,
tempo-testnet,
ethereum,
polygon,
bsc,
optimism,
arbitrum,
base,
zora,
arbitrumnova,
astar-zkevm,
apechain,
hedera,
coti,
lightlink,
mantle,
skale-nebula,
sei-pacific-1,
chiliz,
avalanche,
xai,
shape,
rari,
scroll,
viction,
mode,
space,
soneium,
story,
u2u-solaris,
abstract,
world-chain,
plume,
flow,
solana,
stellar
​
tokens
string
required

The tokens to query. Comma-separated list of either tokens or token locator strings

​
status
enum<string>
required

The status of the transfers to query

Available options:
successful,
failed
​
fromDate
string<date-time>

Filter transfers from this date (inclusive). ISO 8601 format. Supported for EVM and Stellar chains.

​
toDate
string<date-time>

Filter transfers until this date (inclusive). ISO 8601 format. Supported for EVM and Stellar chains.

Response

The wallet activity has been successfully retrieved.

Bidirectional cursor paginated response

​
data
object[]
required

Incoming wallet transfer event

​
nextCursor
string
​
previousCursor
string