Billing Model
What Artax bills.
This page explains what is billed, what stays included, what becomes prepaid on mainnet-beta, and the exact amounts current actions consume.
Billing follows what you actually do.
Artax meters usage by route, action, project, API key, and cluster. This page turns that into a clear customer view so you can tell what is free, what is prepaid, and what does not count against your balance.
Never billed
Public status routes, admin routes, and quote-only or non-executed outcomes do not consume customer balance.
Included in the sandbox
Current non-mainnet usage stays included instead of burning prepaid balance, but allowance and abuse limits still apply.
Prepaid on mainnet-beta
Paid mainnet-beta advisory review reduces prepaid USDC balance and shows up in the dashboard. Most account and dashboard actions remain included.
Execution requests stay separate
Execution request routes are not priced like simple advisory review. They follow their own approval and sponsorship flow.
Billing boundaries
Things the billing model will not do
- Unused prepaid balance does not expire solely due to time passage.
- Billing mode is visible in the usage dashboard by billing mode, route family, usage unit, project, API key, and cluster.
- Devnet and other non-mainnet environments do not silently fall through to prepaid continuation when the current policy says to wait.
- Shared commercial balance and cluster-attributed usage records remain separate concepts.
What this page is not
This page explains current billing behavior. It is here to make charges predictable, not to bury you in accounting language.
No charge
Not billed
Public status and discovery routes
Public health, public config, and public trust reads do not consume customer balance or included allowance.
Operator-only control routes
Operator-only routes are operational tooling and must never bill a customer balance.
Non-executed or denied outcomes
Quote-only calls, preflight denials, unsupported requests, and non-executed intents are not billed to customers.
Included
Included
Current non-mainnet customer usage
Current non-mainnet usage stays included instead of reducing prepaid balance. Free-tier and anti-abuse limits still apply, and exhaustion becomes a wait-state where the current policy requires it.
Prepaid
Prepaid
Current paid mainnet-beta usage
Current paid mainnet-beta advisory review is recorded as prepaid usage and reduces the shared prepaid USDC balance, while most account and dashboard actions remain included today.
Separate flow
Execution requests
Execution-capable submit routes
Execution-capable submit routes are not marketed as simple advisory prepaid billing. They remain governed by sponsorship eligibility, reviewed intent, and execution economics.
Route classes
Route families and how they behave
Public status and discovery routes
public_unmeteredPublic health or static-discovery route that should not consume prepaid balance.
Example routes
Builder review routes
builder_review_meteredBuilder-facing review route intended for account-scoped sandbox/free-tier or prepaid advisory balance accounting.
Example routes
Account and dashboard routes
account_commercial_meteredInitial local-first account, project, API-key, funding, and usage routes that meter against the prepaid account ledger model where appropriate.
Example routes
Execution request routes
execution_request_not_advisory_billedExecution-capable route where sponsored execution remains the primary revenue engine rather than simple advisory billing.
Example routes
Admin routes
operator_internal_not_customer_billedOperator-only routes that should never bill a customer balance.
Example routes
Free-tier behavior
Current advisory allowance policy
Free-tier access is available immediately after account creation, but it is sandbox-oriented, authority-limited, account/project/API-key windowed, and subject to anti-farming controls with prepaid fallback where configured.
advisory_review_request
24-hour window with 250 account, 100 project, and 50 API-key units.
Exhaustion behavior
What happens when the advisory allowance runs out
On devnet, allowance exhaustion becomes a wait-state until the current window resets rather than silently continuing as prepaid usage.
On testnet, allowance exhaustion becomes a wait-state until the current window resets rather than silently continuing as prepaid usage.
On mainnet-beta, advisory free-tier exhaustion may continue as prepaid usage when the current policy allows it and prepaid balance is available.
Unit pricing and reporting labels
What each current action costs when prepaid billing applies
Each current action below consumes the listed usage units when it is metered. Non-mainnet still stays included by policy, but mainnet-beta prepaid deduction uses the exact amounts shown here.
Advisory review carries a small prepaid charge, execution requests stay on a separate approval path, and most account and dashboard actions still remain included in the current product.
Review and execution-prep requests
These are the request units most closely tied to live review traffic. Advisory review is prepaid, while execution requests follow their own approval path.
advisory_review_request
1 unitOne advisory analyze request against a supported route family.
Units consumed
1
Mainnet-beta prepaid amount
0.00075 USDC
sponsored_execution_request
1 unitOne sponsored execution request evaluated under bounded sponsorship policy.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
Account and funding reads
These units cover account posture, balance state, funding status, and current balance-ledger reads.
account_onboarding_state_read
1 unitOne canonical account onboarding-state read including verification status, default project, sandbox-key summary, trust tier, and authority posture.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
account_overview_read
1 unitOne canonical account-overview retrieval event including trust, authority, route-limit, and restriction posture.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
account_funding_status_read
1 unitOne canonical account funding-status retrieval event including balance state, funding state, and funded-upgrade posture.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
account_balance_read
1 unitOne machine-readable account-balance read against the prepaid balance surface.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
account_balance_adjustment_read
1 unitOne recent account balance-adjustment ledger read showing funding credits, pending releases, and usage-linked prepaid deductions.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
account_balance_ledger_read
1 unitOne time-range-aware account balance-ledger read, including funding credits, pending releases, usage debits, and daily movement buckets.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
funding_instruction_issue
1 unitOne funding-instruction retrieval event for a funded account flow.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
funding_event_query
1 unitOne recent account funding-event history query.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
Projects and API keys
These units cover listing, creating, updating, issuing, and revoking projects or API keys.
project_listing_operation
1 unitOne project-list retrieval event scoped to an Artax account.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
project_creation_operation
1 unitOne new project creation event scoped to an Artax account.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
project_metadata_update_operation
1 unitOne governed project metadata mutation for a supported display-name update.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
api_key_listing_operation
1 unitOne API-key inventory retrieval event scoped to an Artax account.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
api_key_creation_operation
1 unitOne account API-key creation event bounded by current caller scopes and authority.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
funded_advisory_key_issue_operation
1 unitOne explicit funded-advisory API-key issuance event once credited prepaid balance is available.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
api_key_revocation_operation
1 unitOne account API-key revocation event.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
Reporting and history
These units already show up in the usage and activity sections of the dashboard.
account_activity_ledger_query
1 unitOne recent unified account activity-ledger query, including category counts plus governed funding, restriction, lifecycle, authority, request-error, and audit summaries.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
account_audit_event_query
1 unitOne recent user-safe account audit-event history query, including safe event-type counts and account change summaries.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
request_error_event_query
1 unitOne recent user-safe account request-error history query, including top-level category counts and denial-relevant guidance fields.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
project_metadata_event_query
1 unitOne recent project metadata-event history query.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
restriction_event_query
1 unitOne recent account restriction-event history query.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
api_key_restriction_event_query
1 unitOne recent API-key restriction-event history query.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
project_restriction_event_query
1 unitOne recent project restriction-event history query.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
usage_reporting_window
1 unitOne usage-summary reporting window returned to a caller.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC
usage_breakdown_read
1 unitOne project-aware and time-range-aware usage-breakdown read, including paid-balance consumption buckets.
Units consumed
1
Mainnet-beta prepaid amount
0 USDC