Wallets

Returns the active wallets of your workspace, newest first (created_at descending). Filter by chain, search the address or label with q, and page with page and limit. The response is a plain wallets array with no total: keep requesting the next page until you get fewer than limit items.

Query Parameters

Response Body

Registers a wallet and attaches it to your workspace. address and label are trimmed; chain is trimmed and uppercased. The address is checked for length and characters only, not against the chain's own address format.

The pair (address, chain) is unique across the whole platform, so creating a pair that already exists fails with 400 Failed to create wallet (address+chain may already exist).

An enrichment lookup (risk score, categories, sanctions) starts in the background right after creation; read it with Enrich a wallet.

Response Body

Soft-deletes a wallet: it disappears from lists, detail, export and schedules, but stays in the trash (List deleted wallets) and can be brought back with Restore a wallet. Its identity links and schedules are kept; schedules do not run while the wallet is deleted.

Query Parameters

Response Body

Partial update of a wallet's label and/or chain; a field you leave out (or send as a non-string) keeps its current value. chain is uppercased. Send label: "" to clear the label. The address cannot be changed: delete the wallet and create a new one instead. Returns 404 when the wallet is not an active wallet of your workspace.

Response Body

Registers 1 to 500 wallets in one call. Each item follows the same rules as Create a wallet and is validated on its own: an item with an invalid address, chain or label, or a pair that already exists, is counted in failed and the rest go through. The response does not say which items failed. Bulk-created wallets are not enriched immediately: the background enrichment sweep picks them up.

Response Body

The trash: soft-deleted wallets of your workspace, newest first. Same filters and paging as List wallets. total is the number of wallets in the trash (it ignores the chain and q filters) and page echoes the page served. Restricted to workspace admins; an API key qualifies while the admin who created it still is one.

Query Parameters

Response Body

Returns one active wallet with the active identities linked to it, most recently linked first. A deleted wallet returns 404.

Query Parameters

Response Body

Returns risk and intelligence data for one of your wallets: address type, categories, labels, sanctions, and a risk score and level, from Seqlense's crypto intelligence provider.

Address the wallet by id (takes precedence) or by exact address. With id, only active wallets are found; with address, the first wallet of your workspace with that address is used, whatever its chain.

Results are stored and reused for 30 days (cached: true). After that, or with force=true, a fresh lookup runs and replaces the stored result. A background sweep also refreshes wallets that were never enriched and results older than 30 days, so most wallets already have data.

If the provider is unreachable or rejects the lookup, the response is still HTTP 200 with {"status": "error", "error": "Enrichment API unavailable"}. Check status before reading the risk fields.

Query Parameters

Response Body

Exports up to 10,000 active wallets, newest first, with the same chain and q filters as List wallets. JSON by default; format=csv returns a text/csv; charset=utf-8 file attachment named wallets-export.csv, with the header row id,address,chain,label,created_at,updated_at and every value in double quotes (quotes inside a label are doubled). Any format other than csv returns JSON.

Query Parameters

Response Body

Associates an identity with a wallet. Both must belong to your workspace, otherwise the call returns 400 Wallet not found or no access or 400 Identity not found or no access. Linking a pair that is already linked succeeds and changes nothing.

Response Body

Removes the link between a wallet and an identity. Returns 404 when the wallet is not in your workspace; unlinking a pair that was not linked still returns ok.

Query Parameters

Response Body

Brings a soft-deleted wallet back from the trash, with its identity links and schedules. Returns 404 when the id is not a deleted wallet of your workspace (including a wallet that is not deleted). Restricted to workspace admins; an API key qualifies while the admin who created it still is one.

Response Body

Recurring work attached to a wallet, ordered by kind, plus the kinds available and the interval bounds a schedule must respect. kind names what recurs; MABU (a recurring market abuse scan) is the only kind today. Returns 404 when the wallet is not an active wallet of your workspace.

Query Parameters

Response Body

Upsert: a wallet holds at most one schedule per kind, so posting a kind that already exists changes its interval and enabled state instead of failing, and clears last_error. The response id is the schedule's id (unchanged on update).

A new enabled schedule is due immediately: the scheduler checks every minute and launches the first run within about a minute. Re-enabling keeps an already planned next run; disabling (enabled: false) parks the schedule without deleting it (next_run_at becomes empty).

A MABU schedule is refused with 400 Market abuse scans do not cover <CHAIN> when the wallet's chain is not one the scanner reads (ETH, BTC, SOL, BSC, POLYGON, ARBITRUM, OPTIMISM, BASE). Other 400s: Unknown kind - must be one of: MABU and interval_days must be between 1 and 90.

Response Body

Deletes the schedule of one kind from a wallet. Returns ok even when there was no such schedule.

Query Parameters

Response Body