Orders

Poll crypto deposit sweep status by order ID or by timestamp

An order is the wallet action that sweeps a deposit into the destination wallet after you create a deposit account. Status is the wallet-action status: pending, succeeded, rejected, or failed. pending means the sweep has not finished: there may be no steps yet, or a step may still be running. succeeded means every step completed. rejected failed before any onchain effects. failed may have onchain effects.

Get an order

Fetch a sweep by wallet action ID. The path wallet is the destination from create. This calls GET /v1/wallets/{wallet_id}/deposit_accounts/crypto/orders/{order_id}.

The request rejects when the wallet or order cannot be loaded.

curl --request GET \
  https://api.privy.io/v1/wallets/{wallet_id}/deposit_accounts/crypto/orders/{order_id} \
  -u "<your-privy-app-id>:<your-privy-app-secret>" \
  -H "privy-app-id: <your-privy-app-id>"

id · string

Wallet action ID of the sweep.

status · 'pending' | 'succeeded' | 'rejected' | 'failed'

Wallet-action status.

Get the next order

Fetch the earliest sweep into the destination wallet after after. after is exclusive. Use this to poll when you do not yet have an order ID. This calls GET /v1/wallets/{wallet_id}/deposit_accounts/crypto/next_order.

The response order is null when no sweep exists after after. The request rejects when the wallet cannot be loaded.

curl --request GET \
  "https://api.privy.io/v1/wallets/{wallet_id}/deposit_accounts/crypto/next_order?after=2026-09-08T20:00:00.000Z" \
  -u "<your-privy-app-id>:<your-privy-app-secret>" \
  -H "privy-app-id: <your-privy-app-id>"

after · string · required

ISO 8601 timestamp. Returns the earliest sweep strictly after this time.

order · object | null

Same {(id, status)} object as get order, or null if no sweep exists after after.

Related

Create a deposit account

Provision deposit addresses

Quotes

Indicative route quotes before creating an address

Get order API

GET /v1/wallets/{wallet_id}/deposit_accounts/crypto/orders/{order_id}

Get next order API

GET /v1/wallets/{wallet_id}/deposit_accounts/crypto/next_order