/deposit-address

GET/v1/agent/deposit-address

Return a Base deposit address

Requires API-key authentication (agentAuth, agentId).

Purpose: return a Base deposit address for an asset.

Auth and scope: header-key auth or OAuth agent:read.

Idempotency: not required.

Query:

json

example

{
  "asset": "USDC",
  "chain": "base"
}

asset is required. Agent API v1 currently supports asset=USDC and chain=base for this route. Omitting asset returns validation_failed.

Response:

json

example

{
  "ok": true,
  "asset": "USDC",
  "chain": "base",
  "address": "0x..."
}

Use this address to fund the same Hightop wallet the agent operates. If deposited funds are later held in Earn, pay approved recipients through POST /v1/agent/payments; do not withdraw first just to make a payment.

Common errors: validation_failed, authentication_failed, insufficient_scope, rate_limited.

Related recipe: Quickstart.