Monthly plans

Monthly plans are available in production. Check GET /api/billing/status for the deployed policy and current checkout availability. Paid plans require an explicit checkout; existing accounts are never automatically charged.

Contact tony@stratatcg.com for more than 50,000 credits.

Credits are shared across all API keys and dashboard lookups on an account. One successful, confident identification costs one credit; one successful price lookup costs one credit. Identify with enrichment reserves two, then returns unused credits. Unresolved identifications, failed prices and prices requiring a selection are not charged. Batch requests charge per item.

Free credits reset at 00:00 UTC on the first of each month. Paid credits expire and renew with each paid monthly subscription period. Unused monthly credits do not roll over. There are no daily, session or weekly account allowances after monthly plans activate. Short-term rate limits and a service-wide daily safety ceiling still protect availability.

There are no automatic overages or automatic top-ups. On exhaustion, wait for reset or choose a larger plan. Pro-to-Scale upgrades take effect after payment of a reviewed prorated charge. They add a proportional credit difference for the remaining period, preserve used credits and keep the original expiry. Scale-to-Pro downgrades take effect at renewal. Cancellation leaves paid credits available until their original expiration. An unpaid renewal grants no new paid credits. After a paid period ends, the account returns to its available Free allowance. Refunds/disputes pause API usage pending support review.

Existing beta accounts

No account or API key needs replacing. Before activation, the dashboard and API headers announce the cutover date. Until then, beta accounts have a 1,000-lookup rolling 24-hour account allowance; it counts attempts, including unresolved identifications and failed pricing. When that account allowance is exhausted, the API returns account_quota_exceeded with retryAt and Retry-After. Stop lookups until that time; the beta billing-status response reports the policy but does not expose the account's live remaining count. daily_limit is a separate service-wide safety ceiling, and rate_limited is a short-term request limit; for both, honor Retry-After.

At cutover, daily counters are not copied into the monthly ledger: everyone starts with 1,000 free credits for the remaining UTC month. No existing account is automatically subscribed or charged.

Instructions for agents

1. Continue using your existing Authorization: Bearer strata_... key.
2. Read GET https://stratatcg.com/connector/api/billing/status with the same key. Once monthly plans are active it reports the plan, remaining credits, resetsAt, and perMinute; before cutover it reports the beta policy, not the live account balance.
3. On account_quota_exceeded, use the policy state: before cutover, stop until response retryAt (or Retry-After) because beta attempts are counted; after cutover, explain remaining, requiredCredits and resetsAt. If payment is enabled, offer the dashboard or prepare an OAuth billing action for the owner's separate review. Show the actual upgrade quote and expiry; a downgrade does not add credits now. Do not ask for a card or password, buy a plan automatically, loop retries, or create extra accounts to bypass limits.
4. On rate_limited or service-wide daily_limit, honor Retry-After; neither is a reason to upgrade an account.
5. Send a stable Idempotency-Key (8–128 letters, digits, dots, colons, underscores or hyphens) for each logical request. Reuse it for network retries with the identical body. Replayed results are not charged again. On request_expired, retry with a new key.

Checkout completion does not itself grant credits. The dashboard updates after Stripe confirms payment. Prices exclude any applicable taxes.

Plan switching uses Strata's reviewed action flow when agent billing is enabled. The Stripe Billing portal supports payment details, invoices, and cancellation at period end; plan switching is handled by Strata so the credit ledger follows the reviewed policy. If switching is unavailable, contact support rather than creating a second subscription.