Verify a wallet

{
  "success": true,
  "data": {
    "verification_id": "c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
    "status": "pending",
    "chain": "solana",
    "chain_name": "Solana",
    "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
    "amount": "0.001042",
    "amount_base": "1042000",
    "currency": "SOL",
    "decimals": 9,
    "receiver": "Hx7kQ...9vRp",
    "expires_at": "2026-10-26T08:34:11Z",
    "seconds_left": 1800,
    "payment_uri": "solana:Hx7kQ...9vRp?amount=0.001042",
    "evm_chain_id": null,
    "instructions": "Send exactly 0.001042 SOL on Solana from 7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW to Hx7kQ...9vRp before 2026-10-26T08:34:11Z. Send it directly from that wallet (a normal transfer, not through an exchange or a contract). The amount is a non-refundable verification fee.",
    "tx_hash": null,
    "explorer_url": null,
    "created_at": "2026-10-26T08:04:11Z",
    "external_id": "user_8412"
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-26T08:04:11Z"
  }
}

{
  "success": true,
  "data": {
    "verification_id": "c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
    "status": "pending",
    "chain": "solana",
    "chain_name": "Solana",
    "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
    "amount": "0.001042",
    "amount_base": "1042000",
    "currency": "SOL",
    "decimals": 9,
    "receiver": "Hx7kQ...9vRp",
    "expires_at": "2026-10-26T08:34:11Z",
    "seconds_left": 1800,
    "payment_uri": "solana:Hx7kQ...9vRp?amount=0.001042",
    "evm_chain_id": null,
    "instructions": "Send exactly 0.001042 SOL on Solana from 7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW to Hx7kQ...9vRp before 2026-10-26T08:34:11Z. Send it directly from that wallet (a normal transfer, not through an exchange or a contract). The amount is a non-refundable verification fee.",
    "tx_hash": null,
    "explorer_url": null,
    "created_at": "2026-10-26T08:04:11Z",
    "external_id": "user_8412"
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-26T08:04:11Z"
  }
}

Proves that a platform user owns a wallet, with the same on-chain payment verification as the CabalSpy ID website: the user sends a tiny, unique amount from the wallet, directly and not through an exchange or a contract. Once the payment is final, the wallet is verified on that chain. Verification is optional. Use it as a trust badge, or because your instance only counts verified wallets (wallet_trust: verified_only). Whoever verifies an address owns it: unverified copies of it on other accounts stop counting.

The amount is a non-refundable verification fee. Show the user the instructions and make clear that the exact amount must be sent from that wallet before expires_at.

Flow

Start

POST /v1/platform-users/wallets/verify with the user, the chain and the address. If the address is not yet one of the user’s wallets, it is added.

Show the payment

Show amount, currency, receiver and expires_at, the payment_uri as a link for wallet apps, or the QR code from GET /v1/platform-users/wallets/verification/qr.

Wait for the payment

Poll GET /v1/platform-users/wallets/verification until status is verified. If the window passes without payment, the status turns expired and you receive the verification.expired webhook.

Start a verification

POST /v1/platform-users/wallets/verify

string

required

Your id of the user. Alternatively pass csid_id.

string

required

The chain to verify on: solana, bnb, base, eth or rh.

string

required

The wallet. It must match the chain: a Solana address on solana, an EVM address on an EVM chain.

curl -X POST "https://api-id.cabalspy.xyz/v1/platform-users/wallets/verify" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"external_id": "user_8412", "chain": "solana", "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW"}'

import time, requests

H = {"Authorization": "Bearer YOUR_KEY"}
v = requests.post("https://api-id.cabalspy.xyz/v1/platform-users/wallets/verify", json={
    "external_id": "user_8412", "chain": "solana",
    "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
}, headers=H).json()["data"]
print(v["instructions"])

while v["status"] == "pending":
    time.sleep(10)
    v = requests.get("https://api-id.cabalspy.xyz/v1/platform-users/wallets/verification",
                     params={"id": v["verification_id"]}, headers=H).json()["data"]
print(v["status"], v["explorer_url"])

const res = await fetch("https://api-id.cabalspy.xyz/v1/platform-users/wallets/verify", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    external_id: "user_8412",
    chain: "base",
    address: "0x4b1e9c0d2a7f3e5b8c6d1a9f0e2b7c4d5a6e8f01",
  }),
});
const { data } = await res.json();
console.log(data.payment_uri, data.expires_at);

Answers 201 with the verification object and external_id.

Response

The verification object, returned by every endpoint on this page.

string

The verification’s id.

string

pending, verified, expired or cancelled.

string

Chain id, for example solana.

string

Chain name, for example Solana.

string

The wallet that must send the payment.

string

The exact amount to send, in the chain’s currency.

string

The same amount in base units (lamports, wei).

string

SOL, BNB or ETH.

integer

Decimals of the currency.

string

The address to send the payment to.

string

End of the payment window.

integer

Seconds until expires_at while pending, otherwise 0.

string

solana:<receiver>?amount=... or ethereum:<receiver>@<chain id>?value=..., for wallet apps and QR codes.

integer

EVM chain id (56, 8453, 1 or 4663), null on Solana.

string

A ready-made sentence to show the user.

string

The payment transaction once seen, otherwise null.

string

Explorer link of the payment, or null.

string

When the verification was started.

string

Your id of the user.

{
  "success": true,
  "data": {
    "verification_id": "c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
    "status": "pending",
    "chain": "solana",
    "chain_name": "Solana",
    "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
    "amount": "0.001042",
    "amount_base": "1042000",
    "currency": "SOL",
    "decimals": 9,
    "receiver": "Hx7kQ...9vRp",
    "expires_at": "2026-10-26T08:34:11Z",
    "seconds_left": 1800,
    "payment_uri": "solana:Hx7kQ...9vRp?amount=0.001042",
    "evm_chain_id": null,
    "instructions": "Send exactly 0.001042 SOL on Solana from 7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW to Hx7kQ...9vRp before 2026-10-26T08:34:11Z. Send it directly from that wallet (a normal transfer, not through an exchange or a contract). The amount is a non-refundable verification fee.",
    "tx_hash": null,
    "explorer_url": null,
    "created_at": "2026-10-26T08:04:11Z",
    "external_id": "user_8412"
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-26T08:04:11Z"
  }
}

Check the status

GET /v1/platform-users/wallets/verification?id=<verification_id> Returns the verification object with external_id. Open verifications are also listed in the user’s pending_verifications.

curl "https://api-id.cabalspy.xyz/v1/platform-users/wallets/verification?id=c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f" \
  -H "Authorization: Bearer YOUR_KEY"

QR code

GET /v1/platform-users/wallets/verification/qr?id=<verification_id> Returns the payment_uri as a QR code, an SVG image (image/svg+xml), not the JSON envelope. Fetch it from your backend and pass it on to your page; your API key must not reach the browser.

curl "https://api-id.cabalspy.xyz/v1/platform-users/wallets/verification/qr?id=c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f" \
  -H "Authorization: Bearer YOUR_KEY" -o verify.svg

Cancel

POST /v1/platform-users/wallets/verification/cancel Cancels an open verification, for example when the user closes the dialog. Returns the verification object with status cancelled and external_id.

string

required

The verification_id.

curl -X POST "https://api-id.cabalspy.xyz/v1/platform-users/wallets/verification/cancel" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "c4d5e6f7-8a9b-4c0d-9e1f-2a3b4c5d6e7f"}'

Errors

Status	Code	Meaning
400	missing_parameter	external_id, chain, address or id missing.
400	invalid_parameter	Unknown or disabled chain, or id is not a verification id.
400	invalid_address	Not a valid address, or the address does not match the chain.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
403	plan_user_limit	The user is beyond your plan’s user limit.
404	platform_user_not_found	No user with this id in your instance.
404	verification_not_found	No verification with this id for your users.
409	account_claimed	The person claimed the account and manages it themselves.
409	wallet_already_verified	Another account already verified this wallet.
409	already_verified	The wallet is already verified on this chain.
409	too_many_wallets	The user would have more than 5 Solana or 5 EVM wallets.
429	too_many_open_verifications	Too many verifications are open at once. Wait or cancel one.
429	rate_limited	Verifications started too fast.
503	service_unavailable	Verification is temporarily unavailable.
429	rate_limit_exceeded	Rate limit exceeded.

See Errors for the full list.

Introduction

Login

Data API

Users

Trading

Theses

Streams

White-Label

Competitions

Reference

Flow

Start a verification

Response

Check the status

QR code

Cancel

Errors

​Flow

​Start a verification

​Response

​Check the status

​QR code

​Cancel

​Errors

Flow

Start a verification

Response

Check the status

QR code

Cancel

Errors