List wallet deposit addresses

curl --request GET \
  --url https://api.paystack.com/v1/wallets/{id}/deposit-addresses \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Deposit addresses fetched successfully",
  "code": "ok",
  "data": [
    {
      "id": "da_01HXYZABC1234567890ABCDEFG",
      "type": "crypto",
      "currency": "USDC",
      "wallet": {
        "id": "wal_01HXYZABC1234567890ABCDEFG",
        "currency": "USDC",
        "label": "USDC Wallet"
      },
      "metadata": {
        "invoice_id": "inv_001"
      },
      "details": {
        "network": "base",
        "address": "0xseedaliceusdc000000000000000000000000"
      },
      "status": "pending",
      "created_at": "2026-05-20T12:00:00.000Z",
      "updated_at": "2026-05-20T12:00:00.000Z",
      "label": "Invoice payments"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 137,
    "has_more": false,
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Wallets

List wallet deposit addresses

List deposit addresses for a wallet. Filter by status or network.

To see inbound payments that arrived at these addresses, use GET /v1/transactions?type=deposit&source_type=deposit_address.

Filtering

status is optional. When provided it must be one of pending, active, frozen, or disabled, and the result is narrowed to deposit addresses with that status. Omit it to return every status.

Pagination

page is 1-indexed (default 1, max 1_000_000). per_page defaults to 50 (max 200). meta.has_more is true when more results exist beyond the current page.

Errors

400 invalid_input — the path id does not start with wal_, status is not a recognised value, or page / per_page is non-numeric or outside the allowed range.
404 not_found — the wallet does not exist in this integration.

GET

wallets

{id}

deposit-addresses

List wallet deposit addresses

curl --request GET \
  --url https://api.paystack.com/v1/wallets/{id}/deposit-addresses \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Deposit addresses fetched successfully",
  "code": "ok",
  "data": [
    {
      "id": "da_01HXYZABC1234567890ABCDEFG",
      "type": "crypto",
      "currency": "USDC",
      "wallet": {
        "id": "wal_01HXYZABC1234567890ABCDEFG",
        "currency": "USDC",
        "label": "USDC Wallet"
      },
      "metadata": {
        "invoice_id": "inv_001"
      },
      "details": {
        "network": "base",
        "address": "0xseedaliceusdc000000000000000000000000"
      },
      "status": "pending",
      "created_at": "2026-05-20T12:00:00.000Z",
      "updated_at": "2026-05-20T12:00:00.000Z",
      "label": "Invoice payments"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 137,
    "has_more": false,
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Path Parameters

string

required

Wallet external id (wal_…).

Pattern: [^\/#\?]+?

Example:

"wal_01HXYZABC1234567890ABCDEFG"

Query Parameters

status

enum<string>

Filter to deposit addresses with this status. Omit to return all.

Available options:

pending,

active,

frozen,

disabled

Example:

"active"

page

integer

default:1

1-indexed page number.

Required range: 1 <= x <= 1000000

Example:

1

per_page

integer

default:50

Page size (1–200).

Required range: 1 <= x <= 200

Example:

50

Response

Deposit addresses fetched successfully

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Deposit addresses fetched successfully"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object[]

required

Show child attributes