> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deribit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# private/add_block_rfq_quote
> **Maker method**
Adds a quote to an existing Block RFQ. To calculate individual leg prices, use [private/get_leg_prices](https://docs.deribit.com/api-reference/combo-books/private-get_leg_prices).
Use [private/get_block_rfqs](https://docs.deribit.com/api-reference/block-rfq/private-get_block_rfqs) to retrieve Block RFQ information, or [private/edit_block_rfq_quote](https://docs.deribit.com/api-reference/block-rfq/private-edit_block_rfq_quote) to modify an existing quote.
**📖 Related Article:** [Deribit Block RFQ API walkthrough](https://docs.deribit.com/articles/block-rfq-api-walkthrough)
**Scope:** `block_rfq:read_write`
[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fadd_block_rfq_quote)
## OpenAPI
````yaml /specifications/deribit_openapi.json get /private/add_block_rfq_quote
openapi: 3.0.0
info:
title: Deribit API
version: 2.1.1
servers:
- url: https://test.deribit.com/api/v2
security: []
tags:
- name: WebSocket Only
description: Can only be used over websockets.
- name: Public
description: Public methods can be used without authentication.
- name: Private
description: >-
Private methods require authentication. All requests must include a
valid OAuth2 token.
A token can be requested using the /public/auth method.
When using the websockets protocol, the token must be included as a
parameter access_token in the message. When using REST (HTTP
GET), the token may also be passed in the Authorization
header.
- name: Authentication
- name: Session Management
- name: Subscription Management
description: >-
Subscription works as [notifications](#notifications), so users will
automatically (after subscribing) receive messages from the server.
Overview for each channel response format is described in
[subscriptions](#subscriptions) section.
- name: Account Management
- name: Trading
- name: Market Data
- name: Wallet
- name: Chat
paths:
/private/add_block_rfq_quote:
get:
tags:
- Block RFQ
- Private
description: >+
**Maker method**
Adds a quote to an existing Block RFQ. To calculate individual leg
prices, use
[private/get_leg_prices](https://docs.deribit.com/api-reference/combo-books/private-get_leg_prices).
Use
[private/get_block_rfqs](https://docs.deribit.com/api-reference/block-rfq/private-get_block_rfqs)
to retrieve Block RFQ information, or
[private/edit_block_rfq_quote](https://docs.deribit.com/api-reference/block-rfq/private-edit_block_rfq_quote)
to modify an existing quote.
**📖 Related Article:** [Deribit Block RFQ API
walkthrough](https://docs.deribit.com/articles/block-rfq-api-walkthrough)
**Scope:** `block_rfq:read_write`
[Try in API
console](https://test.deribit.com/api_console?method=%2Fprivate%2Fadd_block_rfq_quote)
parameters:
- name: label
in: query
schema:
type: string
required: false
description: >-
User defined label for the Block RFQ quote (maximum 64 characters).
Used to identify quotes of a selected Block RFQ
- name: block_rfq_id
required: true
in: query
schema:
type: integer
description: ID of the Block RFQ
- in: query
name: amount
required: true
schema:
$ref: '#/components/schemas/amount'
description: >-
This value multiplied by the ratio of a leg gives trade size on that
leg.
- in: query
name: direction
required: true
schema:
$ref: '#/components/schemas/direction'
description: Direction of trade from the maker perspective
- in: query
name: legs
required: true
schema:
type: array
items:
type: object
properties:
instrument_name:
$ref: '#/components/schemas/instrument_name'
description: Instrument name
price:
type: number
description: Price for trade
ratio:
type: integer
description: Ratio of amount between legs
direction:
$ref: '#/components/schemas/direction'
description: >-
Direction of selected leg. Must match the direction of the
corresponding leg in the Block RFQ
description: List of legs used for Block RFQ quote
style: form
explode: true
- in: query
name: hedge
required: false
schema:
type: string
description: 'JSON string containing: instrument_name, direction, price, amount'
description: >-
Hedge leg of the Block RFQ. There is only one hedge leg allowed per
Block RFQ
- name: execution_instruction
required: false
in: query
schema:
type: string
enum:
- all_or_none
- any_part_of
description: >-
Execution instruction of the quote. Default - `any_part_of`
- `"all_or_none (AON)"` - The quote can only be filled
entirely or not at all, ensuring that its amount matches the amount
specified in the Block RFQ. Additionally, 'all_or_none' quotes have
priority over 'any_part_of' quotes at the same price level.
- `"any_part_of (APO)"` - The quote can be filled either partially
or fully, with the filled amount potentially being less than the
Block RFQ amount.
- in: query
name: price
required: false
schema:
type: number
description: Aggregated price used for quoting future spreads.
- name: expires_at
required: false
in: query
schema:
type: integer
example: 1745312540321
description: >-
The timestamp when the quote expires (milliseconds since the Unix
epoch)
requestBody:
content:
application/json:
examples:
request:
value:
jsonrpc: '2.0'
id: 1
method: private/add_block_rfq_quote
params:
label: example_quote
block_rfq_id: 3
amount: 10000
direction: buy
legs:
- instrument_name: BTC-15NOV24
price: 69600
ratio: '1'
direction: buy
hedge:
amount: 10
direction: buy
price: 70000
instrument_name: BTC-PERPETUAL
execution_instruction: any_part_of
expires_at: 1745312540321
description: JSON-RPC Request Example
description: JSON-RPC request body
responses:
'200':
$ref: '#/components/responses/PrivateAddBlockRfqQuoteResponse'
components:
schemas:
amount:
type: number
description: >-
It represents the requested order size. For perpetual and inverse
futures the amount is in USD units. For options and linear futures it is
the underlying base currency coin.
direction:
enum:
- buy
- sell
type: string
description: 'Direction: `buy`, or `sell`'
instrument_name:
example: BTC-PERPETUAL
type: string
description: Unique instrument identifier
PrivateAddBlockRfqQuoteResponse:
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: The JSON-RPC version (2.0)
id:
type: integer
description: The id that was sent in the request
result:
$ref: '#/components/schemas/block_rfq_quote'
required:
- jsonrpc
- result
type: object
block_rfq_quote:
properties:
creation_timestamp:
type: integer
example: 1536569522277
description: >-
The timestamp when quote was created (milliseconds since the Unix
epoch)
last_update_timestamp:
type: integer
example: 1536569522277
description: >-
Timestamp of the last update of the quote (milliseconds since the
UNIX epoch)
block_rfq_id:
type: integer
description: ID of the Block RFQ
block_rfq_quote_id:
type: integer
description: ID of the Block RFQ quote
quote_state:
type: string
description: State of the quote
execution_instruction:
enum:
- any_part_of
- all_or_none
type: string
description: >-
Execution instruction of the quote. Default - `any_part_of`
- `"all_or_none (AON)"` - The quote can only be filled entirely or
not at all, ensuring that its amount matches the amount specified in
the Block RFQ. Additionally, 'all_or_none' quotes have priority over
'any_part_of' quotes at the same price level.
- `"any_part_of (APO)"` - The quote can be filled either partially
or fully, with the filled amount potentially being less than the
Block RFQ amount.
price:
type: number
description: Price of a quote
amount:
type: number
description: >-
This value multiplied by the ratio of a leg gives trade size on that
leg.
direction:
$ref: '#/components/schemas/quote_direction'
filled_amount:
$ref: '#/components/schemas/filled_amount_quote'
legs:
$ref: '#/components/schemas/leg_structure'
hedge:
$ref: '#/components/schemas/block_rfq_hedge_leg'
replaced:
$ref: '#/components/schemas/replaced_quote'
label:
type: string
description: User defined label for the quote (maximum 64 characters)
app_name:
type: string
example: Example Application
description: >-
The name of the application that placed the quote on behalf of the
user (optional).
quote_state_reason:
type: string
description: Reason of quote cancellation
type: object
quote_direction:
enum:
- buy
- sell
type: string
description: Direction of trade from the maker perspective
filled_amount_quote:
type: number
description: >-
Filled amount of the quote. For perpetual and futures the filled_amount
is in USD units, for options - in units or corresponding cryptocurrency
contracts, e.g., BTC or ETH.
leg_structure:
items:
properties:
ratio:
type: integer
description: Ratio of amount between legs
instrument_name:
example: BTC-PERPETUAL
type: string
description: Unique instrument identifier
direction:
enum:
- buy
- sell
type: string
description: 'Direction: `buy`, or `sell`'
price:
type: number
description: Price for a leg
type: object
type: array
block_rfq_hedge_leg:
properties:
amount:
type: integer
description: >-
It represents the requested hedge leg size. For perpetual and
inverse futures the amount is in USD units. For options and linear
futures it is the underlying base currency coin.
instrument_name:
example: BTC-PERPETUAL
type: string
description: Unique instrument identifier
direction:
enum:
- buy
- sell
type: string
description: 'Direction: `buy`, or `sell`'
price:
type: number
description: Price for a hedge leg
type: object
replaced_quote:
type: boolean
description: '`true` if the quote was edited, otherwise `false`.'
responses:
PrivateAddBlockRfqQuoteResponse:
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateAddBlockRfqQuoteResponse'
examples:
response:
value:
jsonrpc: '2.0'
id: 1
result:
label: example_quote
amount: 10000
direction: buy
price: 69600
legs:
- direction: buy
price: 69600
instrument_name: BTC-15NOV24
ratio: 1
creation_timestamp: 1731076586371
block_rfq_id: 3
replaced: false
filled_amount: 0
hedge:
amount: 10
direction: buy
price: 70000
instrument_name: BTC-PERPETUAL
last_update_timestamp: 1731076586371
block_rfq_quote_id: 8
quote_state: open
description: Response example
description: Success response
````