FAQ
Do I need API keys to call the gateway?
Not for the raw gateway payment flow. Paid routes useHTTP 402 plus x-payment instead of a normal API key model.
When should I use managed wallet mode?
Use it when you want an easier operator flow for repeated paid calls and do not want to build your own raw x402 signing loop for each request.When should I use raw x402 mode?
Use it when you want direct control over payment orchestration, are testing the public protocol path, or are integrating an external payer.Can routes be free?
Yes. A listing or endpoint can be configured so payment is not required before forwarding.What is the best discovery surface for agents?
GET /:api_slug/metadata
What is the best execution surface for agents?
POST /:api_slug/execute
What does MCP-native mean here?
It means the listing exposes structured agent-facing metadata such as operations, schema hints, tags, and other machine-usable fields that make discovery and use easier for agent tooling.When should I use passthrough instead of /execute?
Use passthrough only when you intentionally need the provider-specific route shape or response format.Which integration path should I use?
Four paths share the same payment flow: the raw Gateway API for maximum control, the remote MCP endpoint for chat-native agents, the JavaScript SDK for Node backends, and the Gateway Skill for coding agents working from a shell.How do I charge for my own skill or service?
Put a payment check in front of it. The simplest way is to publish it as a listing so the gateway returns402 Payment Required for unpaid requests and only forwards paid ones to your origin, no payment code on your side. See Payment Checks.
What does Apiosk charge per call?
On the USDC rail, Apiosk takes a flat 2% platform fee at the moment of settlement, publishers receive 98% of each call, on whichever network the buyer paid. On Base the split is enforced by the on-chainApioskSettlement contract, so it is verifiable from any block explorer. The fee was reduced from 10% to 2% so that publishers keep substantially more of each call.
Which networks can buyers pay on?
Base and Solana are live; Polygon and Arbitrum are coming soon. A paid route’s402 lists one accepts entry per network the API is configured for, all at the same USDC price, and always includes a Base entry as fallback, so a 402 is always payable. See Multi-chain Settlement.
What does Apiosk charge on SEPA?
Nothing per transaction. SEPA Direct Debit is priced as a monthly subscription tier, only Mollie’s standard SEPA fee applies on the bank side.Can I force a specific payment rail?
Yes. SendX-Payment-Rail: x402, X-Payment-Rail: sepa, or X-Payment-Rail: credits on the request. If you omit the header, the gateway picks the cheapest viable rail for the buyer and falls back automatically if the preferred rail is unavailable.