Billing and credits

Weir is prepaid. You hold a balance of credits, every successful call spends some, and there is no subscription and no invoice at the end of the month. When the balance runs out, calls stop: you can never be billed for more than you bought.

What a call costs

You pay for results returned, not requests made.

A successful call also costs a 1-credit minimum, even when it returns nothing: reaching a platform is the expensive part whether or not it had an answer. Every operation publishes its price in an x-weir-billing extension, shown on its reference page.

The 3:1 ratio between Reddit and X is not a pricing lever. Reddit results cost us more to produce, and it is stated openly because the honest way to compare any two APIs is a rate per thousand results, which is how pricing publishes it.

What costs nothing

• Failed calls. Anything 400 or above costs nothing, including 503.
• Refused calls. 402 and 429 never charge.
• The control plane. Creating, listing, and triggering monitors and webhooks.
• Introspection. /v1/whoami, /v1/usage, /v1/limits. Working out why you ran out of credit should not spend credit.

Where credits come from

• Free grant. 5,000 credits a month, no card needed. They arrive with your first call of the month, expire when the month ends, and do not roll over. One free grant per person: if you own several workspaces, your oldest one receives it.
• Credit packs. Bought in the dashboard under Billing by a workspace owner or admin. Purchased credits never expire.

Prices are in US dollars, before any sales tax or VAT, which is added at checkout. Card payments are processed by Dodo Payments, our merchant of record. You can also pay in USDC on Solana; see below.

Spending always uses the credits that expire soonest first: this month's free grant before anything you bought.

Paying with USDC

Every pack can also be paid in USDC on Solana, at one USDC per dollar: the $20 pack costs 20 USDC. Under Billing, choose Pay with USDC (Solana) on a pack. The dashboard shows a Solana Pay request:

• a QR code to scan with a mobile wallet (Phantom, Solflare, or any wallet that supports Solana Pay), and an Open in wallet link for a wallet on the same device;
• the amount, the recipient address, and a reference, each with a copy button.

Scanning or opening the request fills everything in. The transfer carries the request's reference, which is how Weir finds it on-chain and ties it to your purchase; nothing else about your wallet is needed. The page updates itself and shows the credits as soon as the transaction is finalized on Solana, usually within a minute of sending it. You can leave the page: the payment is still found, and your purchase history links back to the request.

Things to know:

• Only USDC on Solana is accepted (mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). USDT, SOL, or USDC sent on another chain is not credited and may not be recoverable.
• Pay the request, not the address. A transfer typed by hand without the reference cannot be matched automatically. If that happens, email billing@weirapp.io with the transaction signature.
• The request is shown as payable for 30 minutes, and Weir keeps looking for its transfer for 24 hours, after which it is marked expired. A transfer that lands later is still credited once it is found: open the request again from your purchase history, or contact us.
• Paying more than the price buys the pack; the excess is refunded on request. Paying less adds no credits: the payment is held for review, and we either let you top it up or refund it.
• Your wallet pays the Solana network fee, a fraction of a cent. There is no sales tax line on a USDC payment and no Dodo invoice; the on-chain transaction is the receipt.

Tiers

Rate limits and how many monitors and webhooks a workspace may have rise with what it has bought in total, net of refunds. They never fall because you spent credits or because time passed.

GET /v1/limits returns your workspace's current tier and its limits.

Reading the meter

x-credits-charged: 24
x-credits-remaining: 9976

x-credits-charged is what that call cost. x-credits-remaining is what your workspace can still spend afterwards. Watch x-credits-charged after an unfamiliar call: because rates differ per platform, a query's price cannot be predicted from the request alone, so reading the header beats modelling it.

GET /v1/usage returns the whole picture: balance, what is reserved by calls still in flight, what is available, and how much of this month's free grant is left and when it resets.

Running out

You get 402 with code quota_exceeded, and it is not retryable. Only a person can clear it, by adding credits under Billing in the dashboard. Retrying never will, however long you wait: a retry loop on a 402 runs forever.

Two other refusals look similar and are not:

• 429 while credits are held. When several calls run at once on a nearly empty balance, each holds enough to cover its worst case until it finishes. If the rest of your balance is held by calls still in flight, the next call gets 429 with Retry-After, and it succeeds once they finish. This one is safe to retry.
• 402 while spending is paused. If a payment is refunded after its credits were spent, or a card payment is disputed, data calls return 402 with details.reason: "billing_hold" until it is resolved. Contact support@weirapp.io.

Monitors

A monitor run costs the 1-credit minimum plus the per-result rate for each new result it stores. Results it has already shown you are not charged again, so a run that finds nothing new costs 1 credit. There is no premium for scheduling.

If a workspace runs out of credits, its monitors pause instead of failing on every run, and the dashboard shows why. They resume by themselves as soon as credits arrive: a purchase, or next month's free grant.

Refunds

An unused credit pack can be refunded within 30 days of purchase; once its credits are being spent it cannot. The free grant is never refundable. See the refund policy.

Refunds of USDC payments are made by hand by support: email billing@weirapp.io from the workspace owner's address with the purchase date. The USDC is returned in full, on Solana, to the wallet that sent it, and the pack's credits are taken back when the refund is made.

Controlling spend

1. limit is per call. Searching both platforms is two calls, so budget for both.
2. Filter upstream. You pay for what was returned, including what you then discard.
3. Bound your pagination. See pagination.