Payments & Credits

Fund your account by sending tokens to your proxy wallet.

Accepted tokens

Token	Type	Backing
SPACE	Native	Network token
USD.s	Fiat-backed	1:1 USD held in bank
USDT.s	Bridged	Locked USDT on origin chain
USDC.s	Bridged	Locked USDC on origin chain

All on the SPACE OS EVM chain (Chain ID 800000).

Top up API credits

After sending tokens to your proxy wallet, register the deposit as an API top-up:

POST /api/user/topup
Content-Type: application/json
Authorization: Bearer <jwt>

{
  "paymentId": "0x<tx_hash>",
  "source": "space_token",
  "amountUsd": 10
}

The backend verifies the on-chain transfer, credits your account, and returns the new balance.

Check balance

GET /api/user

Returns:

{
  "credits": {
    "balance": 9.42,
    "spend": 0.58,
    "maxBudget": 10.00
  }
}

balance is remaining USD credits; spend is consumed; maxBudget is the configured cap.

For wallet model and proxy address retrieval, see Wallet Management. For tier pricing and subscription billing, see /pricing.