Skip to main content
When you create an account, Venly provisions the crypto wallets that hold its funds. You don’t manage keys or contracts directly — you read balances and move funds through the API.

​
The two-wallet model

Each account has an account wallet on the account’s chain, holding the customer’s balance. On self-custody accounts the holder signs a permit so Venly can move its funds; on Venly-managed accounts that’s handled for you.
Accounts set up for card payments (coming soon) get a second, always Venly-managed escrow wallet for funds in flight during settlement. You never sign for it.

​
Custody type

A wallet’s type is either VENLY_MANAGED (Venly holds the keys) or SELF_CUSTODY (your customer holds them). This is fixed by your company setup and changes how funds move — see Venly-managed vs self-custody.

​
Reading wallets

List wallets for an account returns each wallet with its address, per-asset balances, and AML status:
Response

​
Balance fields

Each asset balance has three amounts, returned as decimal strings: total = available + reserved. When an operation reserves funds, the amount moves from available to reserved; when it completes, the funds either leave the wallet or return to available.

​
AML status

amlStatus reflects the wallet’s screening: PENDING, APPROVED, or REJECTED. A wallet must clear AML (and, for self-custody, have a confirmed permit) before it can move funds.
List wallets exposes amlStatus only. For Venly-managed wallets, amlStatus: APPROVED means ready. For self-custody, also check the permit status: once the account wallet’s permit is CONFIRMED, Venly can move its funds. See Approving transfers without gas.

​
Next steps

Approving transfers without gas

Let Venly move a self-custody wallet’s funds with a gasless permit.

List wallets

The endpoint reference, with the full response schema.