Tollbridge Docs

Pricing

Generated from the single price source — per-call USDC economics over x402, no account, no API key.

Tollbridge prices per decision, in USDC, settled over x402 on Base. The table below is generated at build time from @tollbridge/core PRICING — the single source of price truth (this portal contains no hand-typed price literals; a conformance test fails if the rendered table drifts from PRICING).

Atomic units are integer USDC 6-decimal units — the exact amount string an x402 challenge carries.

EndpointPrice (USDC)Atomic unitsNetwork
market.quote$0.0011000eip155:8453
market.depth$0.0011000eip155:8453
market.klines$0.0011000eip155:8453
perp.funding$0.0022000eip155:8453
perp.oi$0.0022000eip155:8453
perp.basis$0.0022000eip155:8453
perp.liquidations$0.0022000eip155:8453
wallet.profile$0.0055000eip155:8453
wallet.events$0.0055000eip155:8453
wallet.state$0.0055000eip155:8453
risk.assess$1.0001000000eip155:8453
decision.deep$1.0001000000eip155:8453
signals.evaluate$1.0001000000eip155:8453
billing.pack.booster_150k$150.000150000000eip155:8453
billing.pack.booster_650k$600.000600000000eip155:8453
billing.pack.booster_2m4$2000.0002000000000eip155:8453
billing.pack.drill$0.01010000eip155:8453
billing.plan.operator$99.00099000000eip155:8453
billing.plan.desk$249.000249000000eip155:8453
billing.plan.desk_pro$499.000499000000eip155:8453
billing.addon.priority$99.00099000000eip155:8453
billing.addon.slot$19.00019000000eip155:8453
billing.addon.hook$49.00049000000eip155:8453
billing.addon.pricelock$0.200200000eip155:8453
billing.export.asset_period$29.00029000000eip155:8453

No account. No API key.

Every paid call is a self-contained transaction: the agent signs an EIP-3009 transferWithAuthorization of the exact PRICING amount and retries the call. There is no signup, no key issuance, no billing relationship — the price IS the product. The settlement recipient for a deployment is published in /.well-known/x402.json (payTo), never assumed.

What this buys in practice:

  • Free — market snapshot, health, pricing, providers, discovery documents, the decision read and replay — plus your first 3 entry-tier questions per payer address (S01 Market regime, S05 Volatility expansion, S06 Funding anomaly). A refusal never spends one of the three, and there is no auto-renewal: plans are 30-day cycles you top up yourself.
  • $1 the floor — running a decision starts at 1,000 credits / $1 (entry tier). Long windows (S07 Funding persistence, S08 Open-interest anomaly) are 2,000 credits / $2; account questions (S09, S10, S11) are 5,000 credits / $5. Judgment-bearing assessments (signals.evaluate, risk.assess) are $1 as well.
  • The price rises on a published ladder — see below; the generated table shows today's prices.

Not sold on this deployment: S02 (liquidation risk), S03 (long squeeze) and S04 (short squeeze). The market-wide liquidation tape is written from a named market-data provider and has not held 24 hourly observations for every market yet, so a request returns a clear "no decision" and refunds the credits. Per-market counts are served at GET /v1/liq/hours?asset=<symbol> and per question at GET /v1/signals (sample_hours_by_asset) — one market's hours never light another market's question. The list is derived from GET /v1/signals, never hand-typed — see v1.

The published price ladder

The USD price of credits rises +25% compounding per rung, and every rung opens at a public milestone:

RungOpens when
11,000 realized outcomes
210,000 realized outcomes
3100,000 realized outcomes
41,000,000 realized outcomes and 1,000 active payers in 30 days
  • 24 hours' notice before a rung takes effect.
  • Prices on in-progress decisions hold — a decision costs the rung it opened at.
  • The ladder is published in full: past rungs, the current rung, and the next milestone.

Plans (30-day cycles — no automatic renewal)

PlanPriceCreditsTerms
ScoutFree—First 3 entry-tier questions free. Does not recharge.
Operator$99150,00030-day cycle. You top up yourself.
Desk$249400,00030-day cycle. You top up yourself.
Desk Pro$4991,000,00030-day cycle. You top up yourself.

Packs (one-off, 60-day expiry)

PackPriceCreditsSKU
$150 pack$150150,000billing.pack.booster_150k
$600 pack$600650,000billing.pack.booster_650k
$2,000 pack$2,0002,400,000billing.pack.booster_2m4

Nothing is sold yet: plans and packs go on sale when Tollbridge opens, as do the planned add-ons — priority (billing.addon.priority, $99), slot (billing.addon.slot, $19), hook (billing.addon.hook, $49) and period history export (billing.export.asset_period, $29). There is no automatic renewal: a plan is a 30-day cycle you top up yourself.

How a payment settles

  1. An unpaid call to a paid endpoint returns 402 with the base64 PAYMENT-REQUIRED header (x402 v2, scheme exact, amount = the PRICING atomic units for that endpoint).
  2. The agent signs the EIP-3009 authorization and retries with PAYMENT-SIGNATURE.
  3. On success the response carries the settlement receipt in PAYMENT-RESPONSE, and the paid decision row is linked to the payment ledger record (payment_id).

The full protocol walkthrough: x402. The live price list is also served free at GET /v1/pricing — same source, same numbers.

On this page