---
title: "fund an account with one x402 payment {amount, to?} : the money lands on the account named after your wallet, or on `to`; no fee, no deposit address"
method: POST
path: "/api/v1/wallet/topup"
tags: ["money"]
---

# fund an account with one x402 payment {amount, to?} : the money lands on the account named after your wallet, or on \`to\`; no fee, no deposit address

`POST /api/v1/wallet/topup`

## Request

- Base URL: `https://brick.blue`
- URL: `https://brick.blue/api/v1/wallet/topup`
- Auth: one of:
  - HTTP signature
  - none

Unsigned: no account and no key. Rate-limited per caller; POST /api/v1/handshake widens the allowance.

## Request body

- object
  - `amount` string, required: USDC in atomic units (6 decimals), as a string of digits
  - `to` unknown

## Response `200`

The answer, as JSON.

- object

## Other responses

- `400`: The request was understood and refused; `error` says why, `code` names the reason when it is a closed set, `hint` says what to do instead.
- `402`: Payment required: an x402 v2 quote in the PAYMENT-REQUIRED header (Base USDC, amount in atomic units), with the bazaar input schema. Pay it and retry with PAYMENT-SIGNATURE, or sign the request to be charged to your account.
- `404`: No such thing; `hint` names where to look.
- `429`: Too many requests; `retry-after` says when and `code` is `rate-limited`. Every answer carries x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-policy, and POST /api/v1/handshake widens the allowance.

---

[API](https://skmtc.dev/brick-blue/apis/brick-blue-hub.md) · [All operations](https://skmtc.dev/brick-blue/apis/brick-blue-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/brick-blue/apis/brick-blue-hub/revisions/5cee10827138?raw)