> ## Documentation Index > Fetch the complete documentation index at: https://docs.0xmonaco.com/llms.txt > Use this file to discover all available pages before exploring further. # Quote an RFQ > Quote an RFQ. A maker places or replaces its quote: a bid, an ask or both. Replacing names the maker's current version; the first quote names 0. ## OpenAPI ````yaml /proto-openapi/api/openapi.yaml put /api/v1/rfqs/{rfqId}/quote openapi: 3.0.3 info: title: Monaco Protocol API description: REST API for the Monaco Protocol hybrid CLOB exchange. version: 1.0.0 servers: - url: https://apimonaco.xyz description: Production (Sei mainnet) security: [] tags: - name: AccountsService - name: AnalyticsService - name: ApplicationsService - name: AuthService - name: BuildercodeRewardsService - name: ComplianceService - name: CopyTradingService - name: DelegatedAgentsService - name: FaucetService - name: FeesService - name: HealthService - name: ManagedMarketsService description: |- Wallet-authenticated maker assignments. The signed session must match both configured maker user and application. Owner IDs are process fences, never auth. Only wallet sessions are supported; delegated-agent sessions receive 403. - name: MarginAccountsService description: |- Current public isolated-margin semantics: - a user has one parent margin account per application scope - opening orders create or reuse isolated position buckets under that parent - parent account creation is handled internally by margin workflows - name: MarketService - name: OrderbookService - name: OrdersService - name: PositionsService description: |- Current public isolated-margin semantics: - positions link to a parent margin account and, when applicable, a bucket id - opening orders create or reuse isolated position buckets under the parent - users can open another isolated position by reusing the parent account with a different market bucket - name: PulseService - name: RfqService - name: SweeperService - name: TraderCodeService - name: TradesService - name: WithdrawalsService paths: /api/v1/rfqs/{rfqId}/quote: put: tags: - RfqService - RFQ summary: Quote an RFQ description: |- Quote an RFQ. A maker places or replaces its quote: a bid, an ask or both. Replacing names the maker's current version; the first quote names 0. operationId: upsert_rfq_quote parameters: - name: rfqId in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpsertRfqQuoteRequest' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RfqQuoteVersion' '400': description: >- Invalid quote, or no side could be placed: RFQ_INSUFFICIENT_BALANCE when the maker cannot fund it, RFQ_QUOTE_REJECTED when the venue refuses it as it would the order, RFQ_SIDE_NOT_REQUESTED when it quotes the side a one-way RFQ did not ask for '401': description: Authentication required '403': description: The caller may not quote this RFQ (its own wallet, or RFQ disabled) '404': description: RFQ not found '409': description: >- Stale expected version, the deadline passed, or the RFQ takes no quotes '503': description: RFQ service unavailable; retry security: - monacoSignature: [] - monacoHttpSignature: [] components: schemas: UpsertRfqQuoteRequest: required: - idempotencyKey - expectedVersion type: object properties: marginMode: type: string description: 'Perpetuals: ISOLATED (the default) or CROSS, as on an order' nullable: true idempotencyKey: type: string expectedVersion: type: integer description: The caller's current version for this RFQ; 0 for its first quote format: int64 bid: $ref: '#/components/schemas/RfqQuoteTerms' ask: $ref: '#/components/schemas/RfqQuoteTerms' validityMs: type: integer description: 15000 to 60000; absent means 60000. Capped at the request deadline format: int64 nullable: true leverage: example: '5' type: string description: >- Perpetuals: the leverage each side's order reserves with, as on an order (required there, refused on spot). Fixed while a side rests: a new version with another leverage or margin mode is refused; withdraw and quote again nullable: true additionalProperties: false RfqQuoteVersion: type: object properties: rfqId: type: string nullable: true format: uuid quoteId: type: string nullable: true format: uuid version: type: integer description: This version; name it to replace or withdraw format: int64 nullable: true bid: $ref: '#/components/schemas/RfqQuoteTerms' ask: $ref: '#/components/schemas/RfqQuoteTerms' issuedAtMs: type: integer format: int64 nullable: true validUntilMs: type: integer format: int64 nullable: true leverage: type: string description: 'Perpetuals: the leverage the quote''s orders reserve with' nullable: true marginMode: type: string description: 'Perpetuals: ISOLATED or CROSS' nullable: true refusedSides: type: array items: $ref: '#/components/schemas/RfqRefusedSide' description: >- Quoted sides the venue refused. A quote reserves funds as a resting limit order does, each side on its own: the version holds only the funded sides, and a refused side on a replacement is withdrawn. When no side is funded the quote is refused instead nullable: true description: A quote version as its maker sees it. RfqQuoteTerms: required: - price - capacity type: object properties: price: example: '65000.5' type: string description: Price in quote units per base unit, exact decimal string capacity: example: '10' type: string description: Capacity in base units, exact decimal string additionalProperties: false description: A quote's price and capacity. RfqRefusedSide: type: object properties: side: type: string description: BID or ASK nullable: true code: type: string description: INSUFFICIENT_BALANCE or QUOTE_REJECTED nullable: true reason: type: string nullable: true description: A quoted side the venue refused; nothing is reserved for it. securitySchemes: monacoSignature: type: apiKey description: >- Ed25519 session-key request signing. Every authenticated request carries three headers: `X-Monaco-PublicKey` (64-char lowercase-hex session public key), `X-Monaco-Timestamp` (Unix milliseconds, within 30s of server time), and `X-Monaco-Signature` (hex ed25519 signature). The signature is over `METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body)`, where the body hash is the SHA-256 of the empty byte string when there is no body. Obtain the session keypair from `POST /api/v1/auth/challenge` followed by `POST /api/v1/auth/verify`. name: X-Monaco-Signature in: header monacoHttpSignature: type: apiKey description: >- RFC 9421 Ed25519 session-key request signatures. Send Signature-Input, Signature, and Content-Digest together; never combine them with X-Monaco-* credentials. The monaco signature covers @method, @path, @query, and content-digest in that order, with created (Unix seconds within 30s of server time), keyid (registered lowercase-hex session public key), and alg=ed25519 parameters. Content-Digest uses RFC 9530 sha-256 over the exact body bytes, including the empty body. Query coverage retains ordering and percent encoding. Timestamp freshness does not reject repeated identical requests; use endpoint idempotency where supported. Existing legacy signing remains supported during server-first migration; SDK RFC 9421 signing is opt-in. See https://docs.0xmonaco.com/reference/http-message-signatures for the complete profile and trust model. name: Signature in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.