API ReferenceTransfers
Request Funding
Get a deposit address and record a pending funding request.
Request Funding
Returns a deposit address for the wallet and records a pending funding entry. Send the specified amount to the deposit address to fund the wallet.
Authentication
Requires X-API-Key header.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Wallet UUID |
Request body
Request
curl -X POST http://localhost:4000/v1/wallets/WALLET_ID/fund \
-H "X-API-Key: ak_your_key" \
-H "Content-Type: application/json" \
-d '{
"amount": "100.00",
"currency": "USDC",
"chain": "base"
}'Response (200)
{
"funding_request_id": "tx-uuid",
"wallet_id": "wallet-uuid",
"deposit_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38",
"amount": "100.00",
"currency": "USDC",
"chain": "base",
"status": "pending",
"message": "Send 100.00 USDC to 0x742d35Cc... on base to fund this wallet."
}Response fields
| Field | Type | Description |
|---|---|---|
funding_request_id | string | Internal request UUID |
wallet_id | string | Wallet UUID |
deposit_address | string | Address to send funds to |
amount | string | Expected amount |
currency | string | Token symbol |
chain | string | Chain to deposit on |
status | string | Always "pending" on creation |
message | string | Human-readable instructions |