Skip to main content
Use the API to request and accept option quotes, run a quoting desk, or read your account’s fills and positions. All trading is RFQ: one option or a package of up to 13 legs executes against a maker’s signed quote.

​
Choose your integration

The CLI includes a maker runner that connects your pricing program over JSON. An in-process TypeScript library is available to onboarded makers. Direct integrations can use HTTP and WebSocket from any language.

​
Accounts and authentication

Create an account in the web app first. Sign in to the API with the same Solana wallet: sign a server nonce and receive a session token. Connectivity defines the message, token lifecycle, and session limits. Trading clients can request quotes with a user account. Responding to requests requires Joyride’s approval and the rfq_quoter role. Maker onboarding covers that process.

​
Environments

Production uses https://joyride.exchange. The sandbox uses https://devnet.joyride.exchange on Solana Devnet, with separate accounts and test funds. Signed quotes bind to their deployment; change the account and deployment configuration when moving environments.

​
Build the RFQ workflow

A taker creates a request with rfq.create, subscribes with rfq.subscribe, and accepts a quote with rfq.accept. A maker subscribes with rfq.maker.subscribe and responds with rfq.maker.respond. Use Quoting RFQs for request and quote fields, Contract specifications for symbols and units, and Fees and limits for budgets and signed ceilings. Reconcile execution from fill records and finality. An unknown response must be resolved before retrying a trade. Delivered maker quotes stay firm until expiry and cannot be cancelled or replaced.

​
Reading with an agent

Give your agent the documentation index, followed by the guide for your task. The REST reference is generated from OpenAPI; the WebSocket reference uses AsyncAPI. MCP holds a session token and can request quotes, but it holds no signing key. Accept a trade through the app or CLI. Set explicit spending and collateral ceilings before unattended CLI use.