Call a paid API

Your agent calls an API that charges per request, and pays for that one request from its budget.

​

How it works

The API answers with a price, and Anchorage pays it from the agent’s budget. An API that also needs its own key gets it from the headers the agent sends. For the full flow and what the agent gets back, see Crypto payments.

​

What the agent provides

• The API endpoint to call.
• An idempotency key, unique per intent.
• The budget to draw on (budget_id).
• Optional: HTTP method, headers, body. Defaults to GET with no body.

​

Check the price first

The agent can check what a call will cost without paying. For a metered merchant, the price is the per-request maximum, and the charge can be lower.

​

When a payment fails

See Errors and retries for which failures to retry, and with which idempotency key.