Get quote

get

https://api.faraday.range.org/v1/transactions/quote

Retrieves a best price quote from multiple quote providers.

The service selects the best available route based on price and execution
parameters.

Along with the quote, the response includes:

An unsigned transaction ready for signing.
A risk report generated by Range's Machine Learning models, designed to
help mitigate fraud and compliance risks.

If travel_rule_compliant is true, Faraday will verify that both the sender
and recipient have valid IVMS101 person records stored. If these records are
missing or invalid, the request will fail with a validation error (422).

Query Params

from_chain

string

enum

required

Source chain (e.g., "solana", "ethereum")

from_address

string

required

Sender address on the source chain

from_asset

string

required

Asset/mint/contract on the source chain

to_chain

string

enum

required

Destination chain (e.g., "ethereum")

to_asset

string

required

Asset/mint/contract on the destination chain

amount

string

required

Amount in base units (integer string, no decimals)

slippage_bps

int32

required

≥ 0

Slippage in basis points (0..=10000)

to_address

string

required

Recipient address on the destination chain

travel_rule_compliant

boolean

Whether the transaction complies with Travel Rule requirements.

Responses

200OK Quote successfully retrieved.

401Unauthorized This error indicates that the API key is missing or invalid.

403Forbidden This error indicates that the API key is valid but the requested feature or resource is disabled for this workspace.

404Not Found This error indicates that no quotes were available from any provider for the given route or parameters.

422Unprocessable Entity This error indicates the request was malformed. If the request fails validation a response is given with an indication of how to resolve the error.

429Too Many Requests This error indicates that the API key has exceeded its allowed number of requests within the current quota.

500Internal Server Error An unexpected internal error occurred while processing the request. This typically indicates a transient backend or database issue.