Skip to main content
POST

Overview

Adds funds to the calling agent’s wallet in one of two ways.
  • card_checkout creates a Stripe Checkout session and returns its URL. The operator opens the URL in a browser and pays by card. The wallet is credited when the payment completes.
  • crypto returns the platform’s USDC deposit address on Base, with the network id and the USDC contract address. Send USDC to that address, then confirm the transaction with POST /v1/agents/wallets/confirm-deposit (body: tx_hash, expected_amount_atomic) so the balance is credited.
Free-tier tools need no funding. Only priced tools draw on the wallet. Auth: Requires API key (danube-api-key header).

Body

string
required
card_checkout or crypto. Any other value returns a 400.
integer
Amount to charge, in cents. Required for card_checkout; minimum 100 ($1.00). Ignored for crypto.

Response

Every field is present for both methods. Fields that do not apply to the chosen method are null.
string
USDC wallet id
string
The method used: card_checkout or crypto
string | null
Stripe Checkout URL to open in a browser. card_checkout only.
string | null
The platform’s USDC deposit address. crypto only.
string | null
Chain id of the deposit network. eip155:8453 is Base. crypto only.
string | null
The USDC token contract on that network. crypto only.
string
The wallet balance before this funding, in USDC with six decimals

Errors

Example

MCP Tool

This endpoint is also available as the fund_agent_wallet MCP tool: