Analytics

Overview

The Monitoring API (https://kapi.cashmere.exchange) serves public data for dashboards, points trackers and transfer monitoring. Every payload uses snake_case keys.

Transactions

GET https://kapi.cashmere.exchange/transactionsmainnet?senders=0xYourAddress&limit=20

Every mainnet transfer made through Cashmere, newest first. /transactions takes the same parameters for testnet, which has no data newer than October 2025.

Query	Type	Description
`senders`	string	Comma-separated sender addresses, in any letter case
`addr_or_tx_hash`	string	An ENS (`.eth`) or SNS (`.sol`) name, an address or a transaction hash. Lookups by address or hash can take over a minute: filter by `senders` instead
`source_domain`	number	Source CCTP domain
`destination_domain`	number	Destination CCTP domain
`start_time`	number	Unix seconds, lower bound on `created_at`
`end_time`	number	Unix seconds, upper bound on `created_at`
`limit`	number	Page size, default 10
`cursor`	string	`next_cursor` from the previous page

{
  "transactions": [
    {
      "id": 882672,
      "source_tx_hash": "0xSourceTxHash…",
      "block": 158712232,
      "source_domain": 2,
      "destination_domain": 3,
      "sender": "0xSenderAddress…",
      "recipient": "0xrecipientaddress…",
      "solana_owner": "0x0000000000000000000000000000000000000000",
      "deposit_amount": 10000000,
      "receive_amount": 9998700,
      "max_fee": 1300,
      "relayer_fee": 190000,
      "is_gas_drop_in_native": false,
      "gas_drop_amount": 0,
      "gas_drop_status": "pending",
      "gas_drop_tx_hash": null,
      "message_hash": "0x0000…",
      "attestation_hash": "0x…",
      "nonce": "0x…",
      "domain_nonce": 82732,
      "version": 2,
      "confirmed": true,
      "destination_tx_hash": "0xDestinationTxHash…",
      "destination_tx_status": "success",
      "source_tx_error": null,
      "attestation_error": null,
      "destination_tx_error": null,
      "has_source_tx_error": false,
      "has_attestation_error": false,
      "has_destination_tx_error": false,
      "created_at": "2026-10-26T14:04:43.31283Z",
      "updated_at": "2026-10-26T14:06:43.422173Z"
    }
  ],
  "next_cursor": "1793021083_882672",
  "has_more": true
}

Fields

Field	Type	Description
`source_tx_hash`, `block`	string, number	The source transaction and its block
`source_domain`, `destination_domain`	number	CCTP domains
`sender`	string	The source wallet
`recipient`	string	The CCTP recipient. Into Solana, the USDC token account
`solana_owner`	string	Into Solana, the wallet that owns `recipient`; zero otherwise
`deposit_amount`	number	USDC burned on the source chain, in base units
`receive_amount`	number	USDC minted to the recipient, after Circle’s fee
`max_fee`	number	Circle’s fee cap, in USDC base units
`relayer_fee`	number	Cashmere’s fee: USDC base units, or the source chain’s smallest native unit when `is_gas_drop_in_native` is `true`
`is_gas_drop_in_native`	boolean	The transfer’s `isNative` flag
`gas_drop_amount`, `gas_drop_status`, `gas_drop_tx_hash`		Gas drop is not offered: always `0`, `pending` and `null`
`message_hash`	string	The CCTP message bytes, despite the name
`attestation_hash`	string	Circle’s attestation
`nonce`, `domain_nonce`	string, number	The CCTP nonce, and Cashmere’s per-domain counter
`version`	number	CCTP version, `1` or `2`
`confirmed`	boolean	The source transaction is confirmed
`destination_tx_hash`	string	The mint transaction. It can be all zeros even on success
`destination_tx_status`	string	`success` once the USDC is minted, `failed` if the mint transaction failed
`source_tx_error`, `attestation_error`, `destination_tx_error`	string or null	Error text for each stage
`has_source_tx_error`, `has_attestation_error`, `has_destination_tx_error`	boolean	Whether each error is set
`created_at`, `updated_at`	string	ISO 8601 timestamps

A relayer_fee in wei can exceed Number.MAX_SAFE_INTEGER, which JSON.parse rounds. Treat it as approximate, or parse the body with a big-integer JSON parser.

Leaderboard

GET https://kapi.cashmere.exchange/users/leaderboard?network=mainnet&limit=50&offset=0

Query	Default	Notes
`network`	`devnet`	Pass `mainnet` for the production leaderboard
`limit`	`50`	Up to `100`; larger values fall back to `50`
`offset`	`0`	Pagination offset
`search`	empty	Case-insensitive username filter, up to 100 characters

{
  "leaderboard": [
    {
      "user_id": 42,
      "username": "cashmerefan",
      "ref_code": "CASHFAN",
      "total_base_points": 5320.5,
      "domain_multiplier": 2.5,
      "domain_total_multiplied_points": 13301.25,
      "referral_points": 1200,
      "total_points_with_referrals": 14501.25,
      "staked_op_nfts": 3,
      "staked_eth_nfts": 1,
      "wallet_count": 4,
      "domain_rank": 128
    }
  ],
  "network": "mainnet",
  "search": "",
  "total_count": 4827,
  "limit": 50,
  "offset": 0,
  "has_more": true
}

Entries without a rank return null and come after ranked users.

Users

Two lookups:

GET /users?domains=builder.csm: one profile, with each bound wallet.
GET /users?wallets=0xabc…_evm,So111…_solana: points per wallet, each written as <address>_<chain_type> (evm, solana, sui or aptos).

An unknown profile returns 404 {"error":"user not found"}.

Profile query

{
  "username": "builder.csm",
  "ref_code": "BUILD",
  "has_twitter": true,
  "has_discord": false,
  "binded_wallets": {
    "evm": "0xabc…",
    "sol": "So111…",
    "apt": "",
    "sui": ""
  },
  "domain_rank": 128,
  "domain_total_multiplied_points": 13301.25,
  "domain_total_multiplied_points_mainnet": 4600,
  "total_points_all_chains": 13301.25,
  "total_points_all_chains_mainnet": 4600,
  "referral_points_earned": 1200,
  "total_points_with_referrals": 14501.25,
  "evm": {
    "address": "0xabc…",
    "chain_type": "evm",
    "swap_points": 1200,
    "swap_points_mainnet": 400,
    "testnet_points": 800,
    "nft_points": 120,
    "points_multiplier": 2.5,
    "total_points_multiplied": 3500,
    "total_points_multiplied_mainnet": 2600,
    "staked_eth_nfts": 1,
    "staked_op_nfts": 3
  }
}

sol, apt and sui have the same fields as evm.

Wallet query

{
  "users": [
    {
      "user_id": 42,
      "username": "cashmerefan",
      "ref_code": "CASHFAN",
      "has_twitter": true,
      "has_discord": false,
      "wallets": [
        {
          "address": "0xabc…",
          "chain_type": "evm",
          "testnet_points": 800,
          "nft_points": 120,
          "swap_points": 1200,
          "swap_points_mainnet": 400,
          "staked_op_nfts": 3,
          "staked_eth_nfts": 1,
          "points_multiplier": 2.5,
          "total_points_multiplied": 3500,
          "total_points_multiplied_mainnet": 2600
        }
      ],
      "total_testnet_points": 800,
      "total_nft_points": 120,
      "total_swap_points": 1200,
      "total_swap_points_mainnet": 400,
      "total_staked_op_nfts": 3,
      "total_staked_eth_nfts": 1,
      "max_multiplier": 2.5,
      "total_points_multiplied": 3500,
      "total_points_multiplied_mainnet": 2600,
      "referral_points_earned": 1200,
      "total_points_with_referrals": 4700
    }
  ]
}

Wallet Binding

The Cashmere app binds wallets to a profile with a signed message.

`GET /users/messages`

GET https://kapi.cashmere.exchange/users/messages?username=builder.csm&address=0xabc…&chain_type=evm

Query	Notes
`username`	Profile name, including `.csm`
`address`	The wallet being bound or unbound
`chain_type`	`evm`, `solana`, `sui` or `aptos`

{ "nonce": "483920" }

The nonce works once: request a new one for every signature.

`POST /users/verify`

Have the wallet sign this exact text, where each \n is a newline:

Please sign this message to bind your wallet to Cashmere:\nProfile: builder.csm\nnonce: 483920

To unbind, sign Please sign this message to unbind your wallet from Cashmere:\nProfile: <username>\nnonce: <nonce> instead. Then send:

POST https://kapi.cashmere.exchange/users/verify
Content-Type: application/json

{
  "username": "builder.csm",
  "address": "0xabc…",
  "chain_type": "evm",
  "type": "bind",
  "signature": "0x…",
  "public_key": "",
  "message": "Please sign this message to bind your wallet to Cashmere:\nProfile: builder.csm\nnonce: 483920"
}

Chain	`signature`	`public_key`
EVM	The `personal_sign` signature, hex	Empty
Solana	The Ed25519 signature, base64	Empty
Sui	The `signPersonalMessage` signature, as the wallet returns it	Empty
Aptos	The Ed25519 signature from the wallet’s `signMessage` (with the nonce), base64	The account’s public key, base64

A successful call returns:

{
  "success": true,
  "username": "builder.csm"
}

Volumes

Endpoint	Returns
`GET /stats/mainnet/volumes`	`{ "network": "mainnet", "total_volume": 315000000000000 }`: lifetime volume in USDC base units
`GET /stats/mainnet/volumes?senders=0xabc…,So111…`	`{ "network": "mainnet", "user_volume": … }` for those wallets
`GET /stats/mainnet/volumes/hourly?limit=24`	Hourly buckets, the last 24 by default
`GET /stats/mainnet/volumes/daily?limit=30`	Daily buckets, the last 30 by default

{
  "network": "mainnet",
  "period": "hourly",
  "limit": 24,
  "offset": 0,
  "volumes": [
    {
      "id": 51234,
      "date": "2026-10-26T00:00:00Z",
      "hour": 16,
      "total_volume_usd": 12500.42,
      "transaction_count": 38,
      "unique_senders_count": 21,
      "calculated_at": "2026-10-26T17:00:04Z"
    }
  ]
}

Daily rows have date, total_volume_usd, transaction_count, avg_unique_senders, period_type and last_updated.

Fees

GET https://kapi.cashmere.exchange/stats/mainnet/fees?period=daily&limit=7

period: hourly (default), daily, weekly or monthly.
limit: the number of buckets, 24 by default and up to 1000.

{
  "network": "mainnet",
  "period_type": "daily",
  "limit": 7,
  "offset": 0,
  "cached": false,
  "relayer_fees_usd": 33.54,
  "total_fees_usd": 360.62,
  "fees": [
    {
      "date": "2026-10-26T00:00:00Z",
      "period_type": "daily",
      "total_fee_usd": 6.72,
      "native_fee_usd": 3.68,
      "stable_fee_usd": 3.04,
      "transaction_count": 38,
      "native_tx_count": 22,
      "stable_tx_count": 16,
      "last_updated": "2026-10-26T17:00:05Z"
    }
  ]
}

relayer_fees_usd sums the buckets, and total_fees_usd adds NFT royalty revenue (detailed in nft_revenue). The last entry of fees is that NFT summary and has no date: skip it when charting.

Transaction Count

GET https://kapi.cashmere.exchange/stats/mainnet/transactions

{
  "network": "mainnet",
  "total_transactions": 48271
}

Chain Shares

GET https://kapi.cashmere.exchange/stats/mainnet/chain-shares

{
  "network": "mainnet",
  "chain_shares": [
    {
      "domain": 0,
      "amount": 2750000,
      "total_amount": 5500000
    }
  ]
}

Amounts are in USDC base units: divide amount by total_amount for each domain’s share. The list also contains IDs that aren’t CCTP domains, such as 30101, so keep only the domains you chart.

Unique Wallets

GET /stats/mainnet/wallets (mainnet) and GET /stats/wallets (testnet) return distinct sender counts:

{
  "unique_senders_count": 18342
}

Caching & Rate Limits

Stats endpoints are cached for 60 seconds, and transaction, leaderboard and user lookups for 5.
No rate limits are published and no rate-limit headers are sent. Poll no faster than the cache interval.

Apart from POST /users/verify for wallet binding, these endpoints only read data. Transfers happen on-chain, from the sender’s wallet.

Welcome

Overview

Products

Goat Street

Goat LP

Developer Resources

API Reference

Overview

Transactions

Fields

Leaderboard

Users

Profile query

Wallet query

Wallet Binding

`GET /users/messages`

`POST /users/verify`

Volumes

Fees

Transaction Count

Chain Shares

Unique Wallets

Caching & Rate Limits

​Overview

​Transactions

​Fields

​Leaderboard

​Users

​Profile query

​Wallet query

​Wallet Binding

​GET /users/messages

​POST /users/verify

​Volumes

​Fees

​Transaction Count

​Chain Shares

​Unique Wallets

​Caching & Rate Limits

Overview

Transactions

Fields

Leaderboard

Users

Profile query

Wallet query

Wallet Binding

`GET /users/messages`

`POST /users/verify`

Volumes

Fees

Transaction Count

Chain Shares

Unique Wallets

Caching & Rate Limits