Stove Protocol Developer
Every integration with Stove starts with the same question: does the trade settle atomically in one shot, or does it go through an order lifecycle before it settles? That's what changes both the trading experience and how pricing works.
Which API Do You Need?
| Your need | Use | Why |
|---|---|---|
| Instant, one-shot execution at a quoted price — get a quote, sign, done | Instant Swap API | Atomic on-chain settlement in a single transaction. Fits wallets, DEX aggregators, and DeFi protocols embedding a swap widget. |
| An order-based trading experience — orders that open, get tracked, and settle asynchronously, closer to a brokerage order book | Precise Execution API | Asynchronous settlement via an order lifecycle. Authenticated (API Key + Signature), supports order creation/cancellation, position queries, and WebSocket order/market push. Fits exchanges and institutional trading platforms. |
Still not sure? Ask whether the trade needs to finalize the instant it's signed, or whether an order that settles over time works (or is even preferable, for pricing). Instant and final → Instant Swap API. Order lifecycle → Precise Execution API. Some integrators use both.
Just Need Data?
If you're only displaying protocol stats, ticker data, or supported chains — no trading involved — the Public API is permissionless and read-only: no key needed. Point your requests at it directly.
A Separate Concern: Corporate Actions
Handling corporate actions (stock splits, dividends, delistings, etc.) isn't tied to which trading API you use — it belongs to whichever platform is ultimately holding positions for end users.
- If you face end users directly, you integrate this yourself.
- If you're B2B2C — you connect through an intermediary that in turn serves end users — it's your downstream partner who needs to integrate this, since they're the one holding positions for the actual end users.
For example: a wallet acquires Stove-issued tokens through Stove's aggregator integration. The aggregator integrates Stove's trading interface, and the wallet integrates with the aggregator to source liquidity — but the wallet is the one whose end users actually hold the tokens, so the wallet also needs to integrate Stove's Corporate Actions interface directly. See Corporate Actions for details.
Base URLs
| Environment | URL |
|---|---|
| Production | https://proto.stove.finance |
| Testnet | https://api-qa.proto.stove.finance |
Get Access
Access requirements differ between the two trading APIs:
- Precise Execution API: contact business@stove.finance with a short description of what you're building. Once onboarded, you'll receive an API Key and API Secret for signing requests.
- Instant Swap API: the Get Quote endpoint itself requires Institution API Key + Signature authentication on either network, and testnet execution requires no whitelisting either. Executing on mainnet requires your calling contract address to be added to an on-chain caller whitelist — contact business@stove.finance with your integration name, calling contract address, supported chain IDs, and a technical contact.
Corporate Actions is issued as its own dedicated key as part of onboarding, regardless of which trading API you use.