Skip to main content
Email support@joyride.exchange with your quoting wallet’s public key, a contact address, and the environment you want to use. Create an account with that wallet in the app for the same environment. Joyride approves the account, enables quoting, and provisions its on-chain RFQ subaccount. Collateral requirements are calculated by the exchange’s portfolio risk system. For testing, start with the Devnet sandbox. Use the checks below to verify the account before sending firm quotes.

​
What onboarding produces

A market maker is a user the exchange has approved and designated. The account itself is yours: create it in the app with the wallet that will quote, as any user does. Designation is then a provisioned role; no API call enables it. The wallet key is the credential; there are no API keys. The quoter role is bound to that wallet, so binding a new key goes through Joyride.

​
Readiness checklist

Run these four checks in order on one authenticated WebSocket session. Each depends on the one before it. Request and response frames are on API Connectivity and Quoting RFQs.
  1. Role. public/auth returns roles containing rfq_quoter. An empty list means the account exists without the role, and every rfq.maker.* method returns RFQ_WRONG_ROLE.
  2. Subscription. rfq.maker.subscribe returns subscribed: true.
  3. Subaccount. GET /api/query/vault-subaccount, with the session token as bearer, returns one row for the account.
  4. Readiness. rfq.maker.poll returns a page instead of RFQ_NOT_READY.
The checklist passes when step 4 returns a page. A session that has not passed must not quote.

​
Reading RFQ_NOT_READY

RFQ_NOT_READY is one error code with several causes, told apart by the message field. The common ones are below; all are retryable: true, but only two clear on their own. retryable: true means the request was well formed and may succeed later. For the two Joyride-owned causes, a retry alone will not clear it. Email support@joyride.exchange if one of those persists.

​
Obligations

  • A delivered quote is firm until its expires_at, with no cancel and no replace. Choose a TTL that hedging can honor, since the quote stands even if prices move.
  • Never call the vault’s cancel_nonce for a nonce once its RFQ is accepted.
  • Reconcile from durable history: GET /api/query/rfq-fills?role=maker is the record of fills, and open requests are purged at settlement.

​
Capital

Your on-chain RFQ subaccount holds the USDC that backs fills. The exchange calculates the required collateral from your account’s risk policy, positions, and proposed trade. Collateral and margin explains package offsets, signed limits, and funding checks. Devnet uses test USDC and shared vault caps described on Devnet Sandbox.

​
Contact

Provisioning, role changes, wallet rotation, and every Joyride-owned cause in the table above go through support@joyride.exchange. Accounts that are not yet provisioned start from Market Making on Joyride. Next: Quoting RFQs