List deposit addresses

GET/v1/deposit_addresses

Newest first. One object per network: an EVM address appears once for each of its networks. Each carries totals, what it received on that network.

Authorization

Send your API key as a bearer token in the Authorization header. Secret API key: Authorization: Bearer ctp_live_sk_…. A publishable key (ctp_…_pk_…) is accepted by these operations only, which serve reference data: getRate, listAssets, listNetworks (each marked x-publishable-key: true). Every other operation refuses it with 403 publishable_key_not_allowed, whatever Origin the request carries: that header binds browsers, not other clients, and nothing on this API relies on it.

Query parameters

Name	Type	Description
limit	integer	Number of items to return (1 to 100). Default 50. Minimum 1, maximum 100.
starting_after	string	Return items after this id: pass next_cursor of the previous page. At most 100 characters.
network	string	Network slug, e.g. bsc, or several separated by commas. At most 528 characters.
status	string	One of active, disabled.
name	string	Exactly this name. At most 64 characters.
q	string	Free text, matched literally and without regard to letter case: part of the name or of the address, or the whole id. At most 128 characters.

Example request

cURL

curl "https://api.ctpeway.com/v1/deposit_addresses" \
  -H "Authorization: Bearer $CTPEWAY_API_KEY"

Node SDK

import { CtpeWay } from '@ctpeway/sdk';

const ctpeway = new CtpeWay(process.env.CTPEWAY_API_KEY);

const result = await ctpeway.depositAddresses.list();

Response

200 OK

Field	Type	Description
data	array of objects
data[].id	string
data[].name optional	string
data[].network	string
data[].address	string
data[].status	string	One of active, disabled, archived.
data[].created_at	string (date-time)
data[].totals	object	What this address received on its network. Confirmed payments only: detected, orphaned and dropped payments are not counted.
data[].totals.payments	integer	Confirmed payments received.
data[].totals.usd_value	string	Their value in USD, each at the price it confirmed at. A decimal number written as a string, with up to 8 decimal places.
data[].totals.last_payment_at optional	string (date-time)	When the latest confirmed payment was detected. Absent while there is none.
data[].totals.received	array of objects	One entry per asset received, by asset symbol.
data[].totals.received[].asset	string	Asset symbol, e.g. USDT.
data[].totals.received[].asset_id	string
data[].totals.received[].contract optional	string
data[].totals.received[].decimals	integer
data[].totals.received[].amount	string	Sum of the confirmed payments in this asset, base units. A whole number written as a string of digits.
data[].totals.received[].usd_value	string	Their value in USD, each at the price it confirmed at. A decimal number written as a string, with up to 8 decimal places.
data[].totals.received[].payments	integer	Confirmed payments in this asset.
data[].livemode	boolean	false for objects of the test environment.
has_more	boolean	Whether more items exist after this page.
next_cursor	string or null	Pass as starting_after to get the next page; null on the last page.

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "network": "string",
      "address": "string",
      "status": "active",
      "created_at": "2026-01-01T00:00:00.000Z",
      "totals": {
        "payments": 0,
        "usd_value": "10.00",
        "last_payment_at": "2026-01-01T00:00:00.000Z",
        "received": [
          {
            "asset": "string",
            "asset_id": "string",
            "contract": "string",
            "decimals": 0,
            "amount": "1000000",
            "usd_value": "10.00",
            "payments": 0
          }
        ]
      },
      "livemode": true
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

The values are placeholders generated from the schema. They show the shape, not real data.

Errors

A failed request answers with the error format described under Errors.

Besides the codes any endpoint can return, this endpoint can answer with these code values:

• invalid_cursor
• network_not_found