CH·02CLI reference

gpu billing deposit

Add funds to your account balance with a stablecoin deposit

Add funds to your account balance with a stablecoin deposit

Synopsis

Creates a deposit and prints the address to send to and the exact token amount to send. Send that amount, of that asset, on that network — and nothing else.

Three things are worth reading twice before you hit send in your wallet:

  • The network is not a suggestion. The address accepts the named asset on
the named network only. USDC sent to a Base address over Ethereum, or over Arbitrum, is not detected and generally cannot be recovered. The command prints a one-line network warning under the table for exactly this reason.
  • The address belongs to this deposit. Each deposit gets its own address.
Sending to an address from an earlier deposit does not credit automatically — it becomes a support ticket.
  • Send the exact amount. Your balance is credited with the value that
actually settles, so a wallet that deducts the network fee from the amount sent will land you slightly short. Short deposits are still credited, at what arrived; see the guide.

The minimum deposit is $5.00 by default — the deployment may set a different floor, and an under-minimum create is rejected with an error naming the current one. Any member of the org may add funds — this is not admin-gated.

--crypto is required. It names the funding method explicitly so that adding another method later cannot silently change what an existing command does.

gpu billing deposit --crypto --chain <network> --asset <token> --amount <usd> [flags]

Examples

# $50 of USDC on Base
gpu billing deposit --crypto --chain base --asset usdc --amount 50

# $250 of USDT on Ethereum, machine-readable
gpu billing deposit --crypto --chain ethereum --asset usdt --amount 250 --output json

# Pull just the address and amount out for a wallet CLI
gpu billing deposit --crypto --chain base --asset usdc --amount 50 \
  --output json | jq -r '"\(.pay_amount) to \(.pay_address) on \(.chain)"'

Options

      --amount float    Amount to deposit in USD (default minimum $5.00; the server enforces the live floor)
      --asset string    Stablecoin to send: usdc|usdt
      --chain string    Network to send on: ethereum|base|arbitrum|polygon|solana
      --crypto          Fund with a stablecoin deposit (required)
  -h, --help            help for deposit

Not every network/asset pair is enabled on every deployment. An unavailable pair returns a validation error naming the chain/asset combination as unsupported rather than silently issuing an address you cannot use.

Output

FieldMeaning
deposit_idUse it with gpu billing deposits get .
statusLifecycle state — starts at created, ends at credited.
pay_addressWhere to send. Unique to this deposit.
pay_amountThe exact token amount, as a decimal string (never a float — the precision matters).
chain / assetThe network and token this address accepts. Nothing else.
amount_usd_centsWhat you asked to deposit, in cents. Not what settled.
credited_centsWhat actually landed on your balance. Absent until credited.
expires_atAfter this, do not send to pay_address — create a new deposit.

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

← The gpu CLI