# /rfq/{id}

Get an RFQ by ID 

Endpoint: GET /rfq/{id}
Version: 1.0

## Path parameters:

  - `id` (integer, required)
    of the RFQ to fetch/perform operation on

## Response 200 fields (application/json):

  - `rfqId` (integer)
    Unique identifier for the RFQ

  - `productId` (integer)
    Internal FIG ID for the associated product

  - `label` (string)
    Customer-provided identifier for the RFQ

Only returned if you are the taker of the RFQ

  - `kind` (string)
    Type of RFQ (e.g., option, future)

  - `strategy` (string)
    Strategy short name (e.g., IFly, Fut Spd, Collar)

  - `description` (string)
    FIG generated description of the RFQ

  - `status` (string)
    Current status of the RFQ
    Enum: "open", "filled", "cancelled", "expired"

  - `baseCurrency` (string)
    Base currency for the trade

  - `quoteCurrency` (string)
    When an RFQ is created a quote currency is provided which is used to determine the list of available  for each .

For example, if a BTC option RFQ is created with , then the  for  will be  and the  for  will be .

If it is created with , then the  for  and  will be .

This is because  supports both  and  options while  only supports  options.

When quoting please use the appropriate quote currency from the  list that is relevant to the  chosen for the quote.

  - `quoteCurrencies` (object)
    Lists for each settlement option the expected quote currency.

The keys are settlement option identifiers (e.g. , ) and the values are the quote currency codes (e.g. , ).

  - `amount` (number)
    Trade amount in base currency units for  and quote currency units for

  - `anonymous` (boolean)
    Whether the taker is anonymous

  - `role` (string)
    Your role in the trade, either  or
    Enum: "taker", "maker"

  - `markPrice` (number)
    Mark price for the RFQ

  - `tradeDirection` (string)
    Direction of the trade (buy or sell)

Only returned if the RFQ has been traded and you are the  or  in the trade.
    Enum: "buy", "sell"

  - `tradePrice` (number)
    Price of the trade

Only returned if the RFQ has been traded and you are the  or  in the trade.

  - `tradeAmount` (number)
    Amount traded in the RFQ's base currency (e.g. BTC)

Only returned if the RFQ has been traded and you are the  or  in the trade.

  - `tradeCreatedAt` (integer)
    Timestamp when the trade was executed (unix timestamp in milliseconds)

Only returned if the RFQ has been traded and you are the  or  in the trade.

  - `tradeId` (integer)
    Unique identifier for the trade

Only returned if the RFQ has been traded and you are the  or  in the trade.

  - `legs` (array)

  - `legs.instrumentId` (integer)
    Instrument ID for the leg

  - `legs.instrumentName` (string)
    Full instrument name

  - `legs.direction` (string)
    Direction of the trade/leg/quote (buy or sell)
    Enum: "buy", "sell"

  - `legs.ratio` (number)
    Ratio for the leg to a max of 2 decimal places

  - `legs.expiry` (string)
    Expiry date of the leg in format "18Jul25"

  - `legs.amount` (number)
    Amount of the leg

  - `hedge` (object)
    The RFQ hedge

  - `hedge.amount` (number, required)
    Amount of the hedge in the hedge item's quote currency

  - `hedge.direction` (string, required)
    Direction of the hedge

  - `hedge.expiry` (string)
    Expiry date for the hedge

  - `hedge.instrumentId` (integer)
    Instrument ID for the hedge

  - `hedge.price` (number, required)
    Price for the hedge in the hedge item's quote currency

  - `settlementCredentials` (object)
    For each of the provided , a corresponding  must be provided.

The credentials must have read/write access for BlockRFQ and BlockTrade on the settlement venue.

  - `settlementOptions` (array)
    A list of available settlement options allowed for the RFQ.

Currently  and  are supported.

  - `quotes` (array)

  - `quotes.rfqQuoteId` (integer)
    Unique identifier for the RFQ quote

  - `quotes.price` (number)
    Price of the asset/leg/quote

  - `quotes.amount` (number)
    Amount of the asset being traded/quoted

  - `quotes.makers` (array)
    Array of makers

  - `quotes.createdAt` (integer)
    Timestamp when the object was created (unix timestamp in milliseconds)

  - `trades` (array)

  - `trades.direction` (string)
    Direction of the trade (buy or sell)

Only returned if the RFQ has been traded and you are the  or  in the trade.
    Enum: "buy", "sell"

  - `trades.price` (number)
    Price paid in the RFQ's quote currency

Only returned if the RFQ has been traded and you are the  or  in the trade.
    Example: 0.02

  - `trades.amount` (number)
    Amount traded in the RFQ's base currency (e.g. BTC)

Only returned if the RFQ has been traded and you are the  or  in the trade.
    Example: 12

  - `trades.exchangeTradeId` (string)
    Unique identifier for the trade on the exchange

Only returned if the RFQ has been traded and you are the  or  in the trade.
    Example: "BLOCK-792841"

  - `trades.createdAt` (integer)
    Timestamp when the trade was executed (unix timestamp in milliseconds)

Only returned if the RFQ has been traded and you are the  or  in the trade.
    Example: 1756802862567

  - `createdAt` (integer)
    Timestamp when the RFQ was created (unix timestamp in milliseconds)

  - `expiresAt` (integer)
    Expiration timestamp for the RFQ (unix timestamp in milliseconds)

## Response 400 fields (application/json):

  - `code` (integer)
    Example: 400

  - `message` (string)
    Example: "Bad Request"

  - `reason` (array)
    Example: ["Invalid input"]

## Response 404 fields (application/json):

  - `code` (integer)
    Example: 400

  - `message` (string)
    Example: "Bad Request"

  - `reason` (array)
    Example: ["Invalid input"]