Operations and recovery
Verify trading fees and manage an agent’s API limits
Check free API usage, prove a supported Bitpont fee was received, and recover quota access without replaying a trade or emailing for a standard key.
Workflow
Read the current allowance
Start with the usage endpoint. Free access works without a partner key. The standard default is 30 request units per IP per minute, subject to shared budgets. Views and batch requests can consume multiple units. Use the returned rate-limit headers and honor Retry-After if a request receives HTTP 429.
Prove a payment on the same execution ticket
Call feeAccess with the executionId and original workspace. If wallet proof is requested, verify and sign the returned nonspending message locally and send ownerSignature. Verification checks a finalized, matching Bitpont receipt for supported Jupiter, Kyber or direct deBridge routes. A quote, network gas or a simulated credit alone cannot establish that payment.
Use the returned expiry
A qualifying receipt opens one hour without the standard request quotas, measured from the on-chain payment time. A fresh qualifying receipt can renew access. Keep the original execution reference if a claim is still pending and check it later. Provider capacity and concurrent workers still apply. For sustained higher usage, email [email protected] with your estimated request volume.
Read free usage and limits on this deployment
curl -fsS "https://www.bitpont.com/api/v1/usage"