Fund a wallet

​

Option 1: The faucet

curl -s "$BASE/fund" \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d "{\"walletId\":\"$WALLET\"}"

{
  "ok": true,
  "data": {
    "transaction": {
      "id": "cktxn0001…",
      "type": "FUND",
      "status": "CONFIRMED",
      "amount": "1000.00",
      "token": "AROUSD",
      "txHash": "0x3d9e…",
      "settlementTxHash": "0x77aa…",
      "walletId": "ckwlt0001…",
      "createdAt": "2026-08-13T09:35:00.000Z",
      "updatedAt": "2026-08-13T09:35:41.000Z"
    }
  }
}

• amount is optional. Omit it for the deployment’s default faucet amount, or pass a decimal string like "250" to request a specific amount.
• Two legs, one call. The ETH top-up and the stablecoin transfer are separate operator transactions; the stablecoin leg’s hash appears in settlementTxHash.
• Rolling 24-hour cap. Faucet volume is capped per account over a rolling day. Exceeding it returns 400; the cap resets as old requests age out.
• Works for external wallets too: the faucet is a plain on-chain send, so watch-only addresses can receive it.

​

Option 2: Receive from anyone

• Dashboard: the Receive screen shows the address, a QR code, a copy button, and a downloadable address card.
• API: fetch the address from GET /wallets/{id}, or produce a shareable .nota address card with GET /wallets/{id}/nota.

​

Verify the result

curl -s "$BASE/balances?walletId=$WALLET" -H "Authorization: Bearer $KEY"