How it works
Each tool has a base price. Your own calls pay that price. A customer’s call pays the base price plus your markup: Your dashboard shows prices and balances in both credits and dollars.Choose who pays
A call is billed to a customer when it names that customer or uses a credential issued for that customer: an end-user token or an end-user agent key. Self-serve Locus Pro accounts pay the listed tool price and don’t set resale prices; see Account and usage.
Set your markup
Add a percentage, a flat fee per call, or both.- Prices use exact decimals and round up to six decimal places at the final step.
- Default markup caps are 100% and $100 flat per call. Contact support to change them.
Global default, per-endpoint overrides
Set a workspace default, then override it for a provider or a single endpoint. The most specific setting wins:1
Set the default
Open Agent tools → Pricing and set your workspace default markup. The
same page lists the tools that don’t use it.
2
Override where needed
Override the default for any provider or endpoint that needs a
different price.
3
Check the result
Review the final price in Agent tools or the
live catalog
before you expose the tool to customers.
Credit denomination
Credits express dollars in units that fit your product. The default is 1,000 credits = $1, so a $0.0039 call costs 3.9 credits.- The ratio is set when the workspace is created and never changes, so customer balances never need converting.
- Upgrading a self-serve account to Enterprise keeps its ratio.
- Settings → Workspace shows your ratio. It changes how prices are displayed, not their dollar value.
How you receive margin
See Earnings and payouts for the holdback period and payout options.
How calls are billed
Most calls have a fixed price. How a call is charged covers reservations, refunds, and retries in full.Response-priced endpoints
Some tools reserve a maximum, then charge for the usage the response reports and release the rest. Your markup applies to the measured base.Live-priced endpoints
Some external services quote a price at call time. Set a credit ceiling on the call, and Locus rejects a higher quote without charging. See Live-quoted endpoints.Failed calls and retries
A call that fails before the provider succeeds isn’t charged. Retrying with the same idempotency key (an ID you send with a call so Locus can spot a retry) never charges twice. A call refused for a low balance or a plan limit doesn’t run or charge; see Tool-call limits.Keep your costs private
End-user tokens and the billing widget show customers only their final price. Only trusted management callers see your base cost and margin.Next steps
Funding and billing
Fund balances and choose how customers pay.
How a call is charged
Reservations, refunds, and retries.