Wallet-check API

Check a wallet before your bot touches it

One call per wallet, an answer your bot can act on, and a webhook when a wanted wallet moves. Paid per check in $COP. Free for anyone using this site.

Endpoint

Check a wallet

GET/v1/check/{wallet}

# the wallet-check API, paid in $COP
GET /v1/check/BWVL…xymg

{
  "result": "wanted",
  "case": "0142",
  "rank": 1,
  "status": "at an exchange",
  "victims": 41,
  "solTaken": 1284
}

field	type	meaning
`result`	string	wanted, linked, dispute or clean
`case`	string	case number when the wallet is wanted, linked or under dispute
`rank`	number	rank on the board, for wanted wallets
`status`	string	on the move, at an exchange, dormant or under dispute
`victims`	number	victims in the case
`solTaken`	number	SOL taken by the wanted wallet
`role`	string	for linked wallets: hop, exchange deposit or new wallet

Webhook

When a wanted wallet moves

POSTyour URL

# POST to your URL when a wanted wallet moves
{
  "event": "wanted.moved",
  "case": "0142",
  "wallet": "BWVL…xymg",
  "to": "Hc2r…Wm9e",
  "sol": 120,
  "signature": "4Hk9…xQ2"
}

Signed with your key so you can verify it came from us.

Limits

Fair use

Each check costs a small amount of $COP, debited from your key's balance. Keys are rate limited per second. A clean result means no one has reported the wallet, not that it is safe.