Wallet verification

The onboarding flow can screen a wallet's transaction history and return a whitelisting decision. Keep the wallet address and your external_user_id to associate the result with the user in your application.

Fields

Field	Type	Meaning
id	integer	Wallet verification record ID
wallet_address	text	Address submitted for analysis
external_user_id	text	User identifier supplied by your application
created_at	timestamp	Submission time
updated_at	timestamp	Last status update
deleted	boolean	Whether the record has been deleted
clean_wallet	boolean	Flag for a newly created wallet with no transaction history
status_id	integer	Current whitelisting decision

Statuses

ID	Status	Meaning
1	Pending	Analysis or review is in progress
2	Approved	Approved after risk review
3	Denied	Rejected because of identified risk
4	Auto-approved	Approved without manual review

Records start as pending. Approved, denied, and auto-approved are final results. Wallets marked clean_wallet: true are auto-approved; use that flag only when your system creates a new wallet with no transaction history.

Receive status changes through wallet verification webhooks.