> ## Documentation Index > Fetch the complete documentation index at: https://docs.joyride.exchange/llms.txt > Use this file to discover all available pages before exploring further. # Taker RFQ lifecycle > Private `quote`, `state`, and `finality` events for the authenticated taker, delivered as `subscription` frames with `params.channel: rfq` on the trading connection after `rfq.subscribe`. ## AsyncAPI ````yaml _generated/asyncapi.yaml rfq id: rfq title: Taker RFQ lifecycle description: | Private `quote`, `state`, and `finality` events for the authenticated taker, delivered as `subscription` frames with `params.channel: rfq` on the trading connection after `rfq.subscribe`. servers: - id: trading protocol: wss host: joyride.exchange bindings: [] variables: [] address: rfq parameters: [] bindings: [] operations: - &ref_5 id: rfqReceive title: Receive taker RFQ lifecycle events type: receive messages: - &ref_6 id: RfqNotification contentType: application/json payload: - name: Private taker RFQ event type: object properties: - name: const type: string description: '2.0' required: false - name: const type: string description: subscription required: false - name: params type: object required: true properties: - name: const type: string description: rfq required: false - name: data type: object required: true properties: - name: type type: string enumValues: - quote - state - finality required: true - name: rfq type: object description: >- Taker view of an RFQ from `rfq.get`, `rfq.list`, and the `rfq` channel. required: true properties: - name: rfq_id type: string description: 16-byte RFQ id encoded as lowercase hexadecimal. required: true - name: client_ref type: string required: true - name: legs type: array description: > Ordered strategy legs. Every instrument must be listed and open, share one underlying and expiry, and be unique both by symbol and by resolved terms `(asset, strike, expiry, kind)`. required: true properties: - name: instrument type: string description: Listed instrument symbol. required: true - name: quantity type: string description: >- Non-zero signed 6dp contracts in taker-buy orientation. required: true - name: state type: string enumValues: - pending - quoted - accepted - submitting - filled - declined - expired - failed required: true - name: request_deadline type: string required: true - name: nearest_leg_close type: integer description: Unix seconds; `min(leg.expiry)` over the legs. required: false - name: deployment type: object description: >- Immutable deployment identity of the margin-vault this RFQ is bound to. Present so a taker can re-derive `quote.taker_subaccount` (PDA seeds `["subaccount", owner]` under `program_id`) and confirm the collateral account it is signing for is its own. SCOPE OF THE GUARANTEE. Deriving from this field checks the gateway against ITSELF, so it catches gateway error (a wrong account_id, an epoch mix-up, a mis-joined quote) but NOT a gateway that chooses both values together. It is one layer of three: the program requires the accept signer to own the subaccount, and the gateway re-derives it. A client that has a pinned program id for its cluster SHOULD compare this value against that pin and reject on divergence; substitute the server value only where no pinned deployment exists (local and unverified clusters, which run a synthetic program id). The check that needs no trust anchor is separate and unskippable: `quote.taker_subaccount` also appears at offset 153 of the 1,050-byte `quote_payload` that hashes to `quote_id`, so a client can compare the two directly. Any taker implementation should do that regardless of whether this field is present. required: false properties: - name: program_id type: string description: Solana base58 program id. required: true - name: deployment_id type: string required: true - name: config_pda type: string description: Solana base58 config PDA. required: true - name: epoch type: integer description: Deployment epoch the RFQ was created under. required: true - name: quote type: object description: >- The maker's immutable signed quote as shown to the taker. required: false properties: - name: quote_id type: string description: >- SHA-256 of the canonical 1,050-byte StrategyQuotePayload. required: true - name: rfq_id type: string description: >- 16-byte RFQ id encoded as lowercase hexadecimal. required: true - name: legs type: array description: > Ordered strategy legs. Every instrument must be listed and open, share one underlying and expiry, and be unique both by symbol and by resolved terms `(asset, strike, expiry, kind)`. required: true properties: - name: instrument type: string description: Listed instrument symbol. required: true - name: quantity type: string description: >- Non-zero signed 6dp contracts in taker-buy orientation. required: true - name: bid type: string description: > Canonical signed decimal with at most six fractional digits. Negative zero, JSON numbers, exponents, and values outside the signed 64-bit 6dp range (`i64::MIN` excluded) are rejected. required: true - name: ask type: string description: > Canonical signed decimal with at most six fractional digits. Negative zero, JSON numbers, exponents, and values outside the signed 64-bit 6dp range (`i64::MIN` excluded) are rejected. required: true - name: maker_subaccount type: string description: Solana base58 PDA. required: true - name: taker_subaccount type: string description: Solana base58 PDA. required: true - name: issued_at type: integer required: true - name: expires_at type: integer required: true - name: quote_payload type: string description: >- Base64 of the canonical 1,050-byte StrategyQuotePayload. required: true - name: maker_signature type: string description: Base64 of the 64-byte Ed25519 signature. required: true - name: funding type: object description: >- Present while the RFQ is quoted and not yet accepted; recomputed from the live risk view. required: false properties: - name: anchored type: boolean description: >- Whether a durable subaccount anchor is covered by the live watcher heartbeat. required: true - name: free_balance type: string required: true - name: buy type: object required: true properties: - name: estimate type: boolean description: >- True only for a writer-side requirement computed over a never-anchored empty portfolio. required: true - name: funded type: boolean description: >- True only for a non-estimated requirement with a covered anchor and `free_balance >= required`. required: true - name: package_cash_delta type: string description: >- Signed cash movement before fees; positive means the taker receives premium. required: false - name: cash_debit type: string description: '`max(-package_cash_delta, 0)`.' required: false - name: fee type: string description: >- Taker trading fee over the current prices: per leg `min(index_notional × taker_fee_bps / 10000, leg_value × trade_fee_cap_bps / 10000)`, floored and summed. required: false - name: max_fee type: string description: >- `fee` plus the taker fee tolerance (1 % by default), rounded up. `required` is computed with `max_fee`; the signer charges the exact fee. required: false - name: writer type: boolean description: >- True when this side leaves the taker short at least one leg. required: false - name: lock_increase type: string description: >- `max(post_fill_locked - current_locked, 0)`; zero when the taker is not a writer. required: false - name: post_fill_locked type: string description: Absolute taker lock after the fill. required: false - name: sell type: object required: true properties: - name: estimate type: boolean description: >- True only for a writer-side requirement computed over a never-anchored empty portfolio. required: true - name: funded type: boolean description: >- True only for a non-estimated requirement with a covered anchor and `free_balance >= required`. required: true - name: package_cash_delta type: string description: >- Signed cash movement before fees; positive means the taker receives premium. required: false - name: cash_debit type: string description: '`max(-package_cash_delta, 0)`.' required: false - name: fee type: string description: >- Taker trading fee over the current prices: per leg `min(index_notional × taker_fee_bps / 10000, leg_value × trade_fee_cap_bps / 10000)`, floored and summed. required: false - name: max_fee type: string description: >- `fee` plus the taker fee tolerance (1 % by default), rounded up. `required` is computed with `max_fee`; the signer charges the exact fee. required: false - name: writer type: boolean description: >- True when this side leaves the taker short at least one leg. required: false - name: lock_increase type: string description: >- `max(post_fill_locked - current_locked, 0)`; zero when the taker is not a writer. required: false - name: post_fill_locked type: string description: Absolute taker lock after the fill. required: false - name: accepted_side type: string enumValues: - buy - sell required: false - name: tx_signature type: string description: Solana base58 transaction signature. required: false - name: fill_finality type: string enumValues: - confirmed - finalized - reverted required: false - name: decline_reason type: string enumValues: - unlisted_instrument - near_expiry - size_limit - stale_data - low_confidence - queue_overflow - timeout required: false - name: failure type: object required: false properties: - name: code type: string enumValues: - RFQ_ATTESTATION_FAILED - RFQ_TX_FAILED required: true - name: detail type: string required: false - name: tx_signature type: string required: false - name: onchain_code type: integer required: false - name: created_at type: string required: true - name: updated_at type: string required: true headers: [] jsonPayloadSchema: type: object required: - jsonrpc - method - params properties: jsonrpc: const: '2.0' x-parser-schema-id: method: const: subscription x-parser-schema-id: params: type: object required: - channel - data properties: channel: const: rfq x-parser-schema-id: data: type: object additionalProperties: false properties: type: type: string enum: - quote - state - finality x-parser-schema-id: rfq: type: object description: >- Taker view of an RFQ from `rfq.get`, `rfq.list`, and the `rfq` channel. properties: rfq_id: &ref_0 type: string pattern: ^[0-9a-f]{32}$ description: 16-byte RFQ id encoded as lowercase hexadecimal. x-parser-schema-id: RfqId client_ref: type: string format: uuid x-parser-schema-id: legs: &ref_1 type: array minItems: 1 maxItems: 13 items: type: object additionalProperties: false description: > One strategy leg. `quantity` is signed and taker-buy oriented: on a `buy` accept the taker receives `quantity` and the maker its negation; on a `sell` accept the taker receives `-quantity` and the maker `quantity`. A 1x2 spread is `+1.000000` and `-2.000000`. Legs keep the taker's submitted order everywhere; nothing sorts them. properties: instrument: type: string description: Listed instrument symbol. example: SOL_USDC-6MAR26-150-C x-parser-schema-id: quantity: allOf: - &ref_2 type: string pattern: ^-?(0|[1-9][0-9]*)(\.[0-9]{1,6})?$ description: > Canonical signed decimal with at most six fractional digits. Negative zero, JSON numbers, exponents, and values outside the signed 64-bit 6dp range (`i64::MIN` excluded) are rejected. x-parser-schema-id: RfqSignedDecimal description: >- Non-zero signed 6dp contracts in taker-buy orientation. x-parser-schema-id: required: - instrument - quantity x-parser-schema-id: RfqLeg description: > Ordered strategy legs. Every instrument must be listed and open, share one underlying and expiry, and be unique both by symbol and by resolved terms `(asset, strike, expiry, kind)`. x-parser-schema-id: RfqLegs state: type: string enum: - pending - quoted - accepted - submitting - filled - declined - expired - failed x-parser-schema-id: RfqState request_deadline: type: string format: date-time x-parser-schema-id: nearest_leg_close: type: integer format: int64 description: Unix seconds; `min(leg.expiry)` over the legs. x-parser-schema-id: deployment: allOf: - type: object description: >- Immutable margin-vault deployment identity the RFQ is bound to; copied verbatim into the signed payloads. properties: program_id: type: string description: Solana base58 program id. x-parser-schema-id: deployment_id: type: string pattern: ^[0-9a-f]{64}$ x-parser-schema-id: config_pda: type: string description: Solana base58 config PDA. x-parser-schema-id: epoch: type: integer minimum: 0 description: Deployment epoch the RFQ was created under. x-parser-schema-id: required: - program_id - deployment_id - config_pda - epoch x-parser-schema-id: RfqDeployment description: >- Immutable deployment identity of the margin-vault this RFQ is bound to. Present so a taker can re-derive `quote.taker_subaccount` (PDA seeds `["subaccount", owner]` under `program_id`) and confirm the collateral account it is signing for is its own. SCOPE OF THE GUARANTEE. Deriving from this field checks the gateway against ITSELF, so it catches gateway error (a wrong account_id, an epoch mix-up, a mis-joined quote) but NOT a gateway that chooses both values together. It is one layer of three: the program requires the accept signer to own the subaccount, and the gateway re-derives it. A client that has a pinned program id for its cluster SHOULD compare this value against that pin and reject on divergence; substitute the server value only where no pinned deployment exists (local and unverified clusters, which run a synthetic program id). The check that needs no trust anchor is separate and unskippable: `quote.taker_subaccount` also appears at offset 153 of the 1,050-byte `quote_payload` that hashes to `quote_id`, so a client can compare the two directly. Any taker implementation should do that regardless of whether this field is present. x-parser-schema-id: quote: type: object description: >- The maker's immutable signed quote as shown to the taker. properties: quote_id: type: string pattern: ^[0-9a-f]{64}$ description: >- SHA-256 of the canonical 1,050-byte StrategyQuotePayload. x-parser-schema-id: QuoteId rfq_id: *ref_0 legs: *ref_1 bid: *ref_2 ask: *ref_2 maker_subaccount: type: string description: Solana base58 PDA. x-parser-schema-id: taker_subaccount: type: string description: Solana base58 PDA. x-parser-schema-id: issued_at: type: integer format: int64 x-parser-schema-id: expires_at: type: integer format: int64 x-parser-schema-id: quote_payload: type: string description: >- Base64 of the canonical 1,050-byte StrategyQuotePayload. x-parser-schema-id: maker_signature: type: string description: Base64 of the 64-byte Ed25519 signature. x-parser-schema-id: required: - quote_id - rfq_id - legs - bid - ask - maker_subaccount - taker_subaccount - issued_at - expires_at - quote_payload - maker_signature x-parser-schema-id: QuoteObject funding: allOf: - type: object additionalProperties: false description: >- Live advisory funding view; the attestation signer remains authoritative. properties: anchored: type: boolean description: >- Whether a durable subaccount anchor is covered by the live watcher heartbeat. x-parser-schema-id: free_balance: oneOf: - &ref_3 type: string pattern: ^(0|[1-9][0-9]*)(\.[0-9]{1,6})?$ description: >- Canonical unsigned decimal with at most six fractional digits; JSON numbers and exponents are rejected. x-parser-schema-id: RfqDecimal - type: 'null' x-parser-schema-id: x-parser-schema-id: buy: oneOf: - &ref_4 type: object additionalProperties: false description: > Taker-perspective requirement for one accept side, computed from one frozen strategy risk view: `required = cash_debit + max_fee + lock_increase`. properties: required: allOf: - *ref_3 description: >- Free balance required to accept this side of the quote. x-parser-schema-id: estimate: type: boolean description: >- True only for a writer-side requirement computed over a never-anchored empty portfolio. x-parser-schema-id: funded: type: boolean description: >- True only for a non-estimated requirement with a covered anchor and `free_balance >= required`. x-parser-schema-id: package_cash_delta: allOf: - *ref_2 description: >- Signed cash movement before fees; positive means the taker receives premium. x-parser-schema-id: cash_debit: allOf: - *ref_3 description: '`max(-package_cash_delta, 0)`.' x-parser-schema-id: fee: allOf: - *ref_3 description: >- Taker trading fee over the current prices: per leg `min(index_notional × taker_fee_bps / 10000, leg_value × trade_fee_cap_bps / 10000)`, floored and summed. x-parser-schema-id: max_fee: allOf: - *ref_3 description: >- `fee` plus the taker fee tolerance (1 % by default), rounded up. `required` is computed with `max_fee`; the signer charges the exact fee. x-parser-schema-id: writer: type: boolean description: >- True when this side leaves the taker short at least one leg. x-parser-schema-id: lock_increase: allOf: - *ref_3 description: >- `max(post_fill_locked - current_locked, 0)`; zero when the taker is not a writer. x-parser-schema-id: post_fill_locked: allOf: - *ref_3 description: Absolute taker lock after the fill. x-parser-schema-id: required: - required - estimate - funded x-parser-schema-id: RfqFundingRequirement - type: 'null' x-parser-schema-id: x-parser-schema-id: sell: oneOf: - *ref_4 - type: 'null' x-parser-schema-id: x-parser-schema-id: required: - anchored - free_balance - buy - sell x-parser-schema-id: RfqTakerFunding description: >- Present while the RFQ is quoted and not yet accepted; recomputed from the live risk view. x-parser-schema-id: accepted_side: type: string enum: - buy - sell x-parser-schema-id: tx_signature: type: string description: Solana base58 transaction signature. x-parser-schema-id: fill_finality: type: string enum: - confirmed - finalized - reverted x-parser-schema-id: decline_reason: type: string enum: - unlisted_instrument - near_expiry - size_limit - stale_data - low_confidence - queue_overflow - timeout x-parser-schema-id: RfqDeclineReason failure: type: object properties: code: type: string enum: - RFQ_ATTESTATION_FAILED - RFQ_TX_FAILED x-parser-schema-id: detail: type: string x-parser-schema-id: tx_signature: type: string x-parser-schema-id: onchain_code: type: integer x-parser-schema-id: required: - code x-parser-schema-id: created_at: type: string format: date-time x-parser-schema-id: updated_at: type: string format: date-time x-parser-schema-id: required: - rfq_id - client_ref - legs - state - request_deadline - created_at - updated_at x-parser-schema-id: RfqObject required: - type - rfq x-parser-schema-id: RfqTakerEvent x-parser-schema-id: x-parser-schema-id: RfqSubscriptionFrame title: Private taker RFQ event example: No examples found bindings: [] extensions: - id: x-parser-unique-object-id value: RfqNotification bindings: [] extensions: - id: x-parser-unique-object-id value: rfq sendOperations: - *ref_5 receiveOperations: [] sendMessages: - *ref_6 receiveMessages: [] extensions: - id: x-parser-unique-object-id value: rfq securitySchemes: [] ````