> ## 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. # /api/query/rfq-fills > Durable fill history for reconciliation ## OpenAPI ````yaml _generated/openapi.yaml GET /query/rfq-fills openapi: 3.1.0 info: title: Joyride Core HTTP API version: 0.1.0 description: | HTTP endpoints served by joyride-core v8 components. Decimal money, price, and quantity fields are strings with up to 8 decimal places unless noted otherwise. servers: - url: https://joyride.exchange/api description: Production security: - bearerAuth: [] tags: - name: Public - name: Query - name: Withdrawals - name: Market Data description: Publicly accessible market data. No authentication required. - name: Account description: Account-scoped history and provisioning. Requires a bearer JWT. paths: /query/rfq-fills: get: tags: - Query summary: List RFQ fill history for the authenticated maker or taker description: >- Strategy fills retain nullable one-leg compatibility columns and carry the authoritative package in `legs`. Every leg includes its instrument registry id, canonical symbol, and signed vault-decimal quantity. `side` is the taker's side for the whole package. Use `/api/query/rfq-positions` for current net exposure rather than replaying this append-only history. operationId: listRfqFills parameters: - $ref: '#/components/parameters/AccountId' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/AfterCursor' - name: rfq_id in: query schema: $ref: '#/components/schemas/Hex16' - name: status in: query schema: type: string enum: - confirmed - finalized - reverted - name: role in: query description: >- Narrows the participant scope to one role. Default is both. `side` on a fill is the taker's, so a consumer describing the caller's own trades wants `taker`; a maker reconciling its quotes wants `maker`. schema: type: string enum: - taker - maker responses: '200': description: RFQ fill rows with an optional continuation cursor content: application/json: schema: $ref: '#/components/schemas/RfqFillRows' '400': $ref: '#/components/responses/QueryError' '401': $ref: '#/components/responses/QueryUnauthorized' components: parameters: AccountId: name: account_id in: query schema: type: integer minimum: 0 Limit: name: limit in: query description: >- Rows per page. Omitted or above 500, the server uses 500; a page shorter than `limit` does not mean the end, so page until `next_cursor` is absent. schema: type: integer minimum: 1 maximum: 500 default: 500 AfterCursor: name: after in: query description: >- Exclusive keyset cursor returned as next_cursor. Supported by accounts and monotone sequence-number lists; unsupported sort orders reject it with 400 rather than silently ignoring it. The decimal value must fit the backing non-negative PostgreSQL BIGINT; overflow returns 400. schema: type: string pattern: ^[0-9]+$ schemas: Hex16: type: string pattern: ^[0-9a-fA-F]{32}$ RfqFillRows: type: object required: - rows properties: rows: type: array items: $ref: '#/components/schemas/RfqFillRow' next_cursor: type: string pattern: ^[0-9]+$ RfqFillRow: type: object required: - rfq_id - source_event_id - taker_account - maker_account - fill_type - price_basis - instrument_registry_id - symbol - size - legs - side - premium - taker_fee - maker_fee - lock_amount - lock_a - lock_b - seq_a - seq_b - attestation_nonce - quote_hash - writer_bitmap - short_count_a - short_count_b - slot - tx_signature - finality - filled_at_unix_ms - filled_seq_no properties: rfq_id: $ref: '#/components/schemas/Hex16' source_event_id: $ref: '#/components/schemas/Hex32' taker_account: type: integer maker_account: type: - integer - 'null' fill_type: const: strategy price_basis: const: package_total instrument_registry_id: type: - integer - 'null' description: One-leg compatibility field; null for multi-leg packages. symbol: type: - string - 'null' description: One-leg compatibility field; null for multi-leg packages. size: type: - string - 'null' pattern: ^[0-9]+(\.[0-9]{1,6})?$ description: One-leg compatibility field; null for multi-leg packages. legs: type: array description: Authoritative package legs in submitted order. items: $ref: '#/components/schemas/RfqFillLeg' side: type: integer enum: - 0 - 1 description: 'Taker side: 0 buy, 1 sell.' premium: $ref: '#/components/schemas/VaultSignedDecimalString' taker_fee: $ref: '#/components/schemas/VaultDecimalString' maker_fee: $ref: '#/components/schemas/VaultDecimalString' lock_amount: type: - string - 'null' lock_a: type: - string - 'null' lock_b: type: - string - 'null' seq_a: type: - integer - 'null' seq_b: type: - integer - 'null' attestation_nonce: type: - integer - 'null' quote_hash: type: - string - 'null' pattern: ^[0-9a-f]{64}$ writer_bitmap: type: - integer - 'null' short_count_a: type: - integer - 'null' short_count_b: type: - integer - 'null' slot: type: - integer - 'null' tx_signature: type: - string - 'null' description: >- A 64-byte signature encoded as 128 hex characters, or null before projection. finality: type: string enum: - confirmed - finalized - reverted filled_at_unix_ms: type: - integer - 'null' filled_seq_no: type: integer QueryErrorResponse: type: object required: - error properties: error: type: string Hex32: type: string pattern: ^[0-9a-fA-F]{64}$ RfqFillLeg: type: object required: - instrument_registry_id - symbol - quantity properties: instrument_registry_id: type: integer symbol: type: string description: Canonical instrument symbol resolved by the query read model. quantity: allOf: - $ref: '#/components/schemas/VaultSignedDecimalString' description: Signed contracts from the taker-buy perspective. VaultSignedDecimalString: type: string description: >- Signed margin-vault fixed-point value with at most 6 decimal places; negative zero is rejected. pattern: >- ^((0|[1-9][0-9]*)(\.[0-9]{1,6})?|-[1-9][0-9]*(\.[0-9]{1,6})?|-0\.(?=[0-9]{0,5}[1-9]$)[0-9]{1,6})$ VaultDecimalString: type: string description: Unsigned margin-vault USDC amount with at most 6 decimal places. pattern: ^[0-9]+(\.[0-9]{1,6})?$ responses: QueryError: description: Query API error response content: application/json: schema: $ref: '#/components/schemas/QueryErrorResponse' QueryUnauthorized: description: >- Missing, expired or invalid bearer token. The body is the plain text `unauthorized`, not JSON. content: text/plain: schema: type: string const: unauthorized securitySchemes: bearerAuth: type: http scheme: bearer description: >- SIWS-issued JWT. Admin commands require the `admin` role, `admin:*`, or the exact `admin:` scope; admin reads use their documented read scope. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.