Rfq Get Best Quote

post

https://api.lyra.finance/private/rfq_get_best_quote

Performs a "dry run" on an RFQ, returning the estimated fee and whether the trade is expected to pass.

Should any exception be raised in the process of evaluating the trade, a standard RPC error will be returned
with the error details. Required minimum session key permission level is read_only

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

client

string

Optional client that sent RFQ

counterparties

array of strings | null

Defaults to null

Optional list of market maker account addresses to request quotes from. If not supplied, all market makers who are approved as RFQ makers will be notified.

counterparties

direction

string

enum

Defaults to buy

Planned execution direction (default buy)

Allowed:

extra_fee

string

Defaults to 0

Extra fee in USDC added to the total final fee paid by user and directly sent to client / builder (must be between 0.000001 and 1000 USDC). The referral_code field must also be filled out. See Builder Fee page in docs for more info.

label

string

Optional user-defined label for the RFQ

legs

array of objects

required

RFQ legs

legs*

max_total_cost

string | null

Defaults to null

An optional max total cost for the RFQ. Only used when the RFQ sender executes as buyer. Polling endpoints and channels will ignore quotes where the total cost across all legs is above this value. Positive values mean the RFQ sender expects to pay $, negative mean the RFQ sender expects to receive $.This field is not disclosed to the market makers.

min_total_cost

string | null

Defaults to null

An optional min total cost for the RFQ. Only used when the RFQ sender executes as seller. Polling endpoints and channels will ignore quotes where the total cost across all legs is below this value. Positive values mean the RFQ sender expects to receive $, negative mean the RFQ sender expects to pay $.This field is not disclosed to the market makers.

partial_fill_step

string

Defaults to 1

Optional step size for partial fills. If not supplied, the RFQ will not support partial fills.

preferred_direction

string | null

enum

Defaults to null

If disclosed, the direction the user is aiming to execute as. Default None.

Allowed:

referral_code

string

Optional referral code for the RFQ

rfq_id

uuid | null

Defaults to null

RFQ ID to get best quote for. If not provided, will return estimates based on mark prices

subaccount_id

integer

required

Subaccount ID

Response

200successful operation