Wallet

AssistantRouter uses a pre-paid wallet system. Check your balance and view transaction history.

Get Balance

Get current wallet balance and auto-topup settings.

Response

{
  "data": {
    "balance_cents": 5000,
    "reserved_cents": 50,
    "available_cents": 4950,
    "auto_topup_enabled": true,
    "auto_topup_threshold_cents": 500,
    "auto_topup_amount_cents": 2000
  }
}

Response Fields

Example

curl https://api.assistantrouter.com/v1/wallet \
  -H "Authorization: Bearer $API_KEY"

const response = await fetch('https://api.assistantrouter.com/v1/wallet', {
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const { data } = await response.json();
console.log(`Available: $${(data.available_cents / 100).toFixed(2)}`);

Get Transaction History

Get a list of wallet transactions.

Query Parameters

Response

{
  "data": [
    {
      "id": "txn_abc123",
      "type": "topup",
      "amount_cents": 2000,
      "balance_after_cents": 5000,
      "description": "Manual top-up",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "txn_xyz789",
      "type": "usage",
      "amount_cents": -15,
      "balance_after_cents": 3000,
      "description": "Chat completion - claude-haiku-4.5",
      "created_at": "2024-01-15T09:15:00Z"
    }
  ]
}

Transaction Types

How Billing Works

1. Pre-paid balance: Add credits to your wallet before making API calls
2. Per-request charging: Each request deducts from your balance based on token usage
3. Streaming reservations: During streaming, we reserve an estimated amount that's adjusted after completion
4. Auto top-up: Optionally enable automatic refills when balance drops below a threshold

Auto Top-up

Configure automatic top-up in the dashboard to ensure uninterrupted service:

1. Go to Settings > Billing
2. Enable Auto Top-up
3. Set a Threshold (e.g., $5.00)
4. Set a Top-up Amount (e.g., $20.00)

When your balance drops below the threshold, we'll automatically charge your payment method and add the top-up amount to your wallet.