GET /api/v1/billing/deposit-address

Operation: getDepositAddress.

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

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).

Endpoint

GET https://amplerun-api.spiry.org/api/v1/billing/deposit-address

Authentication

Use the credential and scope required by this operation. For programmatic renter/host calls: Authorization: Bearer $AMPLERUN_API_KEY. A host-agent signature or other specialized proof is required where the description specifies it.

Responses

200

The deposit address and recent deposits.

application/json

Field	Type	Presence	Description
chain_id	8453	Required
network	“base”	Required
address	EvmAddress	Required
networks	array of 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.
assets	array of object	Required
min_deposit_micro	MicroAmount	Required
max_deposit_micro	MicroAmount or null	Required	Room left under the account balance cap; null = no limit.
finalized_block_number	DecimalString or null	Required
deposits	array of object	Required

{
  "$ref": "#/components/schemas/DepositAddress"
}

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.

application/json

Field	Type	Presence	Description
error	object	Required

{
  "$ref": "#/components/schemas/ErrorEnvelope"
}

Static request outline

Replace path/query placeholders and provide the required JSON body, headers and credential from the sections above. This is a request outline, not a command that chooses an amount or starts a rental for you.

curl --request GET 'https://amplerun-api.spiry.org/api/v1/billing/deposit-address' \
  --header "Authorization: Bearer $AMPLERUN_API_KEY"

Schema definitions · Download OpenAPI · Authentication · Errors and recovery