---
title: "This account's own deposit address (the same on every listed network, created on first call), plus recent deposits"
method: GET
path: "/api/v1/billing/deposit-address"
tags: ["billing"]
---

# This account's own deposit address (the same on every listed network, created on first call), plus recent deposits

`GET /api/v1/billing/deposit-address`

## Request

- Base URL: `https://amplerun-api.spiry.org`
- URL: `https://amplerun-api.spiry.org/api/v1/billing/deposit-address`
- Auth: HTTP bearer

Send USDC or USDT, or the network's own coin (ETH, POL, BNB, AVAX), to `address` on any network in `networks`, from anywhere: an exchange or any wallet. No wallet linking and no transaction hash are needed. Each stablecoin transfer is credited exactly once, after that network's finality, 1:1. A native coin is credited in USD at the Chainlink price at finality minus `native.spread_bps`. The address never changes. Funds sent on a network not listed in `networks` are not credited. `deposits` lists recent deposits: SEEN (on chain, waiting for finality; display only), CREDITED, or HELD (arrived but over a balance cap; credited automatically once there is room).

## Response `200`

The deposit address and recent deposits.

- DepositAddress
  - `chain_id` 8453, required
  - `network` 'base', required
  - `address` string, required
  - `networks` object[], required: Every network this address is watched on right now (Base first). The address is the same on each. Stablecoins credit 1:1; the native coin credits in USD at the Chainlink price at finality minus spread_bps.
    - `key` 'base' | 'arbitrum' | 'ethereum' | 'optimism' | 'polygon' | 'bnb' | 'avalanche' | 'sei' | 'xlayer' | 'robinhood' | 'arc', required
    - `chain_id` integer, required
    - `caip2` string, required
    - `name` string, required
    - `native_symbol` string, required
    - `explorer_url` string, uri, required
    - `assets` object[], required
      - `asset` 'USDC' | 'USDT', required
      - `contract` string, required
    - `native` object, nullable, required: null when the native coin is not credited on this network.
      - `symbol` string, required
      - `spread_bps` integer, required
      - `quote_micro_per_coin` string, required: Unsigned base-10 integer as string; never a float.
      - `price_updated_at` string, date-time, required
    - `status` 'OK' | 'UNAVAILABLE', required
    - `finalized_block_number` string, required: Unsigned base-10 integer as string; never a float.
    - `wallet_add_chain` object, nullable: EIP-3085 wallet_addEthereumChain parameters (public RPC and explorer), for a wallet that doesn't know this network yet. Read-only; null when no public RPC is known. Absent from older servers.
      - `chainId` string, required
      - `chainName` string, required
      - `nativeCurrency` object, required
        - `name` string, required
        - `symbol` string, required
        - `decimals` integer, required
      - `rpcUrls` string[], required
      - `blockExplorerUrls` string[], required
  - `assets` object[], required
    - `asset` 'USDC' | 'USDT', required
    - `contract` string, required
  - `min_deposit_micro` string, required: Unsigned base-10 integer as string; never a float.
  - `max_deposit_micro` string, required: Unsigned base-10 integer as string; never a float.
  - `finalized_block_number` string, required: Unsigned base-10 integer as string; never a float.
  - `deposits` object[], required
    - `chain_id` integer, required
    - `network` string, required
    - `tx_hash` string, nullable, required: null for a native-coin credit (credited from the address balance at finality, not per transaction).
    - `log_index` integer, nullable, required
    - `asset` 'USDC' | 'USDT' | 'ETH' | 'POL' | 'BNB' | 'AVAX', required
    - `amount_micro` string, required: Unsigned base-10 integer as string; never a float.
    - `amount_wei` string, required: Unsigned base-10 integer as string; never a float.
    - `block_number` string, required: Unsigned base-10 integer as string; never a float.
    - `state` 'SEEN' | 'CREDITED' | 'HELD', required
    - `blocks_to_finality` string, required: Unsigned base-10 integer as string; never a float.
    - `reason` string, nullable, required
    - `created_at` string, date-time, required

## Other responses

- `503`: Deposit addresses are not configured on this server.
- `default`: Error envelope. 401 unauthenticated, 403/404 forbidden, 409 conflict, 422 invalid input, 429 rate limited (code UNAVAILABLE, retryable:true, no Retry-After header), 503 unavailable money/provider state with retryable:true.

---

[API](https://skmtc.dev/amplerun/apis/amplerun-business-api.md) · [All operations](https://skmtc.dev/amplerun/apis/amplerun-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/amplerun/apis/amplerun-business-api/revisions/40944687fa52?raw)