Credits

Amounts are integers in micro-USDC: 1,000,000 equals $1 of credit. These endpoints are read-only; top up and change limits in the dashboard.

GET /v1/credits

Your balance. available_micro_usdc is what new requests can use: deposits and card credit, minus spending and open holds.

curl https://lyber-paid-acceptance-gateway-production.up.railway.app/v1/credits -H "Authorization: Bearer $LYBER_API_KEY"

{
  "currency": "USDC",
  "decimals": 6,
  "available_micro_usdc": 9640000,
  "spent_micro_usdc": 310000,
  "reserved_micro_usdc": 50000,
  "deposited_micro_usdc": 0,
  "stripe_credit_micro": 10000000,
  "promotional_credit_micro": 0,
  "refunded_micro_usdc": 0
}

GET /v1/credits/limits

This month's spending limits and committed spend (UTC month), for the account and for the key making the call. A monthly_limit_micro of null means no limit.

{
  "currency": "USDC",
  "decimals": 6,
  "month_start": "2026-10-01T00:00:00+00:00",
  "account": {"monthly_limit_micro": 50000000, "committed_micro": 360000, "remaining_micro": 49640000},
  "key": {"key_id": "…", "monthly_limit_micro": null, "committed_micro": 120000, "remaining_micro": null}
}

GET /v1/credits/requests

Your requests and their charges, newest first. limit sets the page size (1–100, default 50); pass before from the previous page to read further back.

POST /v1/credits/reservation-preview

The credit hold a request would need, without sending it. The body is exactly model and max_tokens.

curl https://lyber-paid-acceptance-gateway-production.up.railway.app/v1/credits/reservation-preview \
  -H "Authorization: Bearer $LYBER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax-m3.1-flash-abliterated", "max_tokens": 4096}'

The response includes reservation_micro_usdc, available_micro_usdc, additional_credit_micro_usdc (how much more you'd need) and affordable. A preview is not binding: prices and your balance can change before you send.