Billing

Computalot uses account credits. When you submit a job, a hold is placed against your balance. After the job completes, the hold settles to actual usage. Supported beta access today is either an admin-issued API key or an admin-whitelisted wallet session, and both see the same billing truth.

How it works

Submit a job — Computalot estimates the cost and places a hold
Job runs — your balance stays reserved
Job completes — the hold settles to the actual cost

If your account can’t cover the estimated hold, the job is rejected before it starts.

Billing truth lives on GET /api/v1/account/balance, GET /api/v1/account/holds, GET /api/v1/account/ledger, and GET /api/v1/account/quotes.

Checking your balance


curl -sS -H "Authorization: Bearer $TOKEN" \
  https://computalot.com/api/v1/account/balance

Returns:

Field	Description
`ledger_balance_usd`	Total credits minus settled charges
`held_usd`	Currently reserved for active jobs
`available_usd`	Spendable balance (ledger minus holds)

Use GET /api/v1/account/holds to inspect active reservations, GET /api/v1/account/ledger for settled credits/debits, and GET /api/v1/account/quotes for open funding or shortfall quotes.

Funding with x402

x402 is the programmatic funding rail. No subscription or credit card needed.


# 1. Request a top-up quote
curl -sS "$BASE_URL/api/v1/account/quotes/topup" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount_usd": 5.0}'
 
# 2. Response: 402 Payment Required with x402 payment details
# 3. Pay with an x402-capable client
# 4. Confirm payment
curl -sS "$BASE_URL/api/v1/account/quotes/<quote_id>/pay/x402" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "PAYMENT-SIGNATURE: <x402 payment payload>"

If POST /api/v1/projects/:name/init returns 402 Payment Required with a shortfall quote, fund the account and retry the same init request.

If POST /api/v1/jobs returns 402 Payment Required with a shortfall quote, fund the account and retry the same submit request.

What’s charged

Job execution — charged against credits, based on resource usage and runtime
Project init — free, but requires at least $5 available balance
Artifact storage — free (7-day retention)

Endpoints

Method	Path	Description
`GET`	`/api/v1/account/balance`	Current balance and holds
`GET`	`/api/v1/account/ledger`	Transaction history
`GET`	`/api/v1/account/holds`	Active holds
`GET`	`/api/v1/account/quotes`	Funding and shortfall quotes
`POST`	`/api/v1/account/quotes/topup`	Request a top-up quote
`POST`	`/api/v1/account/quotes/:id/pay/x402`	Confirm x402 payment