Skip to main content
Receiving a digital asset is a single end-to-end flow: create a wallet and deposit address, verify and share it, then track the incoming deposit and—when it arrives from an unrecognized sender—attribute it before the funds become available. This page walks the full path. For the shared wallet and address mechanics, see Deposit. Two endpoints describe the same deposit from different angles, and you use both once funds are inbound:
  • GET /v2/transactions — the money view: how much arrived, in what asset, from which address, and its on-chain status.
  • GET /v2/deposit-attributions/attributions — the compliance view: whether the deposit is held or cleared, and who sent it.
They link on the transaction id, which is the depositTransactionId in the attributions response, and both carry the same blockchainTxId.

Deposit flow

1

Create a wallet

Call POST /v2/vaults/{vaultId}/wallets, passing the networkId and a walletName.
2

Provision a deposit address

Call POST /v2/wallets/{walletId}/addresses, or list existing addresses with GET on the addresses endpoint.
3

Verify the address

Anchorage Digital signs every deposit address so you can confirm it was generated for your organization and hasn’t been tampered with. Confirm both that the signature is valid and that the signed address matches the one you intend to share. See Address verification.
4

Share the address and receive the asset

Share the verified address with the sender, who sends only the correct asset on the correct network. If you expect recurring deposits from this sender, add their address as a trusted source so future deposits attribute automatically and skip the manual step below.
5

Track the incoming deposit

Subscribe to webhooks to be notified on arrival. A deposit from an unrecognized sender fires deposit.pending-attribution with the transactionId. Read the deposit with GET /v2/transactions: it shows status: SUCCESS on-chain, but the funds are excluded from availableBalance until attribution completes.
6

Check attribution status

The same deposit appears under GET /v2/deposit-attributions/attributions with status: PENDING and empty originator fields—this is what you complete. No amount or value is returned here. A deposit from a trusted source is already ATTRIBUTED at this point, so you can skip the next step.
7

Attribute the sender

Identify who sent the funds. Attribution via API requires the Deposit Attribution permission.
The record moves to status: ATTRIBUTED, and the funds are released into availableBalance. A deposit.attributed webhook fires to confirm.
Poll GET /v2/transactions to reconcile the money and GET /v2/deposit-attributions/attributions to clear the hold. A deposit can be SUCCESS on-chain while still PENDING for KYT.

Trusted sources and automatic attribution

Not every deposit needs the manual attribution step. Attribution is applied automatically when:
  • Trusted sources — Any address you add as a trusted source is attributed automatically on future deposits. Create them in the dashboard (not currently available via API). They’re recommended for senders you receive from repeatedly, and turn the flow above into a track-only path.
  • Travel rule — Crypto deposits from VASPs above the $2,100 travel-rule reporting threshold are attributed automatically when Anchorage Digital receives a travel-rule message from a participating VASP. This isn’t instant; use the API if you need faster access to funds.
  • Everything else needs manual attribution.

Field guidance

  • originatorName and originatorCountry — The actual person or entity that sent the funds, not the financial institution.
  • sourceWalletTypeCUSTODIAL when the sender doesn’t hold the private key (a third party does, for example an exchange or custodian), or SELF_HOSTED when the sender holds the private key (for example, a self-custody wallet).
Deposits identified as spam or dusting can be attributed as spam through the spam endpoint, which keeps unwanted balances out of statements and trading balances.

Attribution status values

Attribution type values

Address integrity

Always verify a deposit address before use. The addresses API returns a signature and metadata that prove the address belongs to your vault and network. See Address verification for the V1 and V2 schemes.

Failed and unrecognized deposits

Sending the wrong asset type to an Anchorage Digital address results in a failed deposit. An asset sent on a different chain than the address is not recognized. If the address is correct but the asset is unsupported—for example, an unsupported ERC-20 sent to an ETH address—contact your client experience team.