Fund Wallet - Naïve

curl -X POST https://api.usenaive.ai/v1/users/user-uuid-1/wallet/fund \ -H "Authorization: Bearer nv_sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "amount": "5.00", "source": "treasury" }'

Credits the agent’s wallet, either from the tenant treasury wallet or from a testnet faucet.

Operator only. Funding requires an operator credential: a signed-in dashboard session, or an API key minted with the wallet:admin scope. An agent key is refused with 403 (reason: wallet_admin_requires_operator).

Request Body

Parameter	Type	Required	Description
`amount`	string	Yes	Decimal USDC string, e.g. `"5.00"` — not cents, not atomic units
`source`	string	Yes	`treasury` (moves USDC from the tenant treasury wallet) or `faucet` (testnet only)
`asset`	string	No	Asset to credit. Defaults to `USDC`

curl -X POST https://api.usenaive.ai/v1/users/user-uuid-1/wallet/fund \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5.00",
    "source": "treasury"
  }'

{
  "txHash": "0x8f2c1de4a90b7356e1c2f8a94b0d6e7351829af0cb3d47e5a61b9c8d2f3e4a5b"
}

Funding emits a wallet.funded audit event, and opportunistically emits wallet.balance.low if the resulting balance is still under the wallet’s lowBalanceThreshold (which defaults to perTxMax).

Errors

Status	Code	When
400	`invalid_input`	`amount` and `source` are both required
403	`forbidden`	The Account Kit has not enabled `payments`, or the caller is not an operator (`wallet_admin_requires_operator`)
404	`resource_not_found`	No wallet for this agent, or — with `source: treasury` — no treasury wallet is configured

CLI

naive use <user-id>
naive wallet fund --amount 5.00 --source treasury

On testnet, credit from the faucet instead:

naive wallet fund --amount 5.00 --source faucet

MCP

No MCP tool — deliberately. Funding is the operator surface and is not exposed to agents: an agent that could top itself up would have no budget at all.

​Request Body

​Errors

​CLI

​MCP

Request Body

Errors

CLI

MCP