Skip to main content

Billing

AML You uses a token-based billing system. Each API operation consumes tokens from your account balance.

How It Works​

Every analysis request follows a three-step billing flow:

Request → Freeze tokens → Run analysis → Spend or Unfreeze
  1. Freeze — Before the analysis runs, the required tokens are reserved (frozen) from your balance
  2. Spend — On successful analysis, the frozen tokens are consumed
  3. Unfreeze — If the analysis fails, the frozen tokens are returned to your balance

This ensures you're never charged for failed operations.

:::tip Avoiding double charges on retry If your client may retry a billable request (network timeout, crash recovery, webhook replay), send an Idempotency-Key header. Replays with the same key return the original job without re-freezing tokens. See Idempotency. :::

Token Consumption​

OperationTokens
Wallet analysisVaries by complexity

Check your consumption from the API Keys section in your dashboard.

Insufficient Balance​

If your account doesn't have enough tokens, the API returns:

HTTP 402 Payment Required
{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient token balance to perform this analysis. Please top up your account."
  }
}

Monitoring Usage​

You can view your token consumption and usage breakdown in your dashboard.