Sign in

Get Wallet Activity (Unstable)

Changed on

Retrieves activity history for the specified wallet including transactions and other relevant events. This is an unstable API that may change without notice.

API scope required: wallets.read

get/unstable/wallets/{walletLocator}/transfers

Request

  • Base URL: https://staging.crossmint.com/api
  • URL: https://staging.crossmint.com/api/unstable/wallets/{walletLocator}/transfers
  • Auth: none declared. Required headers: X-API-KEY

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>

Query parameters

cursorstring
limitstring
sort'asc' | 'desc'
chain'arbitrum-sepolia' | 'arc-testnet' | 'avalanche-fuji' | 'curtis' | 'base-sepolia' | 'bsc-testnet' | 'chiliz-spicy-testnet' | 'ethereum-sepolia' | 'hypersonic-testnet' | 'mantle-sepolia' | 'optimism-sepolia' | 'polygon-amoy' | 'crossmint-private-testnet-ethereum' | 'crossmint-private-testnet-polygon' | 'scroll-sepolia' | 'sei-atlantic-2-testnet' | 'shape-sepolia' | 'skale-nebula-testnet' | 'space-testnet' | 'story-testnet' | 'verify-testnet' | 'zora-sepolia' | 'abstract-testnet' | 'flow-testnet' | 'tempo-testnet' | 'robinhood-chain-testnet' | 'celo-sepolia' | 'ethereum' | 'polygon' | 'bsc' | 'optimism' | 'arbitrum' | 'base' | 'zora' | 'arbitrumnova' | 'apechain' | 'mantle' | 'skale-nebula' | 'sei-pacific-1' | 'chiliz' | 'avalanche' | 'shape' | 'scroll' | 'space' | 'story' | 'abstract' | 'flow' | 'tempo' | 'robinhood-chain' | 'celo' | 'arc' | 'solana' | 'stellar' required

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

tokensstring required

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

status'successful' | 'failed' required

The status of the transfers to query

fromDatestring date-time

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

toDatestring date-time

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

Headers

X-API-KEYstring required

API key required for authentication

Response

The wallet activity has been successfully retrieved.

nextCursorstring
previousCursorstring

Example response

{
  "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",
      "transferId": "93fd7f08-0c63-4d73-808b-6268e665c964",
      "completedAt": "2025-10-21T12:34:56.789Z",
      "onChain": {
        "txId": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "explorerLink": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      },
      "type": "wallets.transfer.in"
    }
  ]
}

Changes

  • 3983c72e453aRevision changes
    • breaking

      removed the enum value astar-zkevm from the query request parameter chain

    • breaking

      removed the enum value base-goerli from the query request parameter chain

    • breaking

      removed the enum value coti from the query request parameter chain

    • breaking

      removed the enum value coti-testnet from the query request parameter chain

    • breaking

      removed the enum value ethereum-goerli from the query request parameter chain

    • breaking

      removed the enum value hedera from the query request parameter chain

    • breaking

      removed the enum value hedera-testnet from the query request parameter chain

    • breaking

      removed the enum value lightlink from the query request parameter chain

    • breaking

      removed the enum value lightlink-pegasus from the query request parameter chain

    • breaking

      removed the enum value mode from the query request parameter chain

    • breaking

      removed the enum value mode-sepolia from the query request parameter chain

    • breaking

      removed the enum value optimism-goerli from the query request parameter chain

    • breaking

      removed the enum value plume from the query request parameter chain

    • breaking

      removed the enum value plume-testnet from the query request parameter chain

    • breaking

      removed the enum value polygon-mumbai from the query request parameter chain

    • breaking

      removed the enum value rari from the query request parameter chain

    • breaking

      removed the enum value rari-testnet from the query request parameter chain

    • breaking

      removed the enum value soneium from the query request parameter chain

    • breaking

      removed the enum value soneium-minato-testnet from the query request parameter chain

    • breaking

      removed the enum value u2u-nebulas from the query request parameter chain

    • breaking

      removed the enum value u2u-solaris from the query request parameter chain

    • breaking

      removed the enum value viction from the query request parameter chain

    • breaking

      removed the enum value viction-testnet from the query request parameter chain

    • breaking

      removed the enum value world-chain from the query request parameter chain

    • breaking

      removed the enum value world-chain-sepolia from the query request parameter chain

    • breaking

      removed the enum value xai from the query request parameter chain

    • breaking

      removed the enum value xai-sepolia-testnet from the query request parameter chain

    • breaking

      removed the enum value zenchain-testnet from the query request parameter chain

    • breaking

      removed the enum value zkatana from the query request parameter chain

    • breaking

      removed the enum value zkyoto from the query request parameter chain

    • breaking

      removed the enum value zora-goerli from the query request parameter chain

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • info

      removed subschema #1 subschema #2 from the / response property oneOf list for the response status

  • 19493bf640a4Revision changes
    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • info

      added the new enum value arc to the query request parameter chain

    • info

      added the new enum value celo to the query request parameter chain

    • info

      added the new enum value celo-sepolia to the query request parameter chain

    • info

      removed subschema #1 subschema #2 from the / response property oneOf list for the response status