Get quotes

curl --request GET \
  --url https://api.faraday.range.org/v1/transactions/quotes \
  --header 'Authorization: Bearer <token>'

{
  "quotes": [
    {
      "amount_in": "5000000",
      "amount_out_estimated": "4998546",
      "created_at": "2025-10-28T17:36:29Z",
      "expires_at": null,
      "fee": {
        "fee_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
        "network_fee": "1454",
        "router_fee": "0",
        "total_fee": "1454"
      },
      "from_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
      "from_chain": "solana-devnet",
      "id": "5917c6e9-4a69-4ca4-90b8-22d9abaf3c8b",
      "min_amount_out": "4983550",
      "provider": "skipgo",
      "provider_context": {
        "route": {
          "estimated_fees": [
            {
              "amount": "1454",
              "bridge_id": "CCTP",
              "chain_id": "solana-devnet",
              "fee_type": "SMART_RELAY",
              "origin_asset": {
                "chain_id": "solana-devnet",
                "coingecko_id": "usd-coin",
                "symbol": "USDC"
              }
            }
          ],
          "estimated_route_duration_seconds": 25
        },
        "txs": [
          {
            "svm_tx": {
              "chain_id": "solana-devnet",
              "signer_address": "3DWrAUpE8DWTyEfexXHcyJzYDieyJCw7pwsSiJRcjzKx",
              "tx": "<base64-encoded Solana transaction>"
            }
          }
        ]
      },
      "to_asset": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
      "to_chain": "sepolia",
      "transactions": [
        {
          "chain_id": "EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
          "kind": "solana",
          "tx_base64": "<base64-encoded Solana transaction>"
        }
      ]
    }
  ],
  "risk": {
    "errors": [],
    "overall_risk_level": "high",
    "processing_time_ms": 4439.167,
    "request_summary": {
      "amount": 100000000,
      "recipient_address": "0x10ADD26fb2D17dA265e0567B8F56cb4687979fbE",
      "recipient_network": "ethereum",
      "recipient_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "sender_address": "GvFbpZcqXNoZbAH8ETAA4DYBzaEHY4v2Vt7r71ZqJCTc",
      "sender_network": "solana",
      "sender_token": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    },
    "risk_factors": [
      {
        "description": "Unable to assess new wallet risk due to service error: Network 'ethereum' is not configured.",
        "factor": "assessment_error_new_wallet",
        "risk_level": "medium"
      },
      {
        "description": "Unable to assess dormant wallet risk: Network 'ethereum' is not configured.",
        "factor": "assessment_error_dormant_wallet",
        "risk_level": "medium"
      },
      {
        "description": "No address poisoning pattern detected between sender and recipient",
        "factor": "no_address_poisoning",
        "risk_level": "low"
      },
      {
        "description": "First ever interaction between these addresses",
        "factor": "first_interaction",
        "risk_level": "high"
      },
      {
        "description": "Sender address is directly connected (1 hop) to malicious addresses (riskScore: 10). Address is directly malicious.",
        "factor": "connected_to_malicious_address",
        "risk_level": "high"
      },
      {
        "description": "Recipient address has no known connections to malicious addresses according to Range API",
        "factor": "clean_address_recipient",
        "risk_level": "low"
      }
    ]
  }
}

GET

transactions

quotes

Get quotes

curl --request GET \
  --url https://api.faraday.range.org/v1/transactions/quotes \
  --header 'Authorization: Bearer <token>'

{
  "quotes": [
    {
      "amount_in": "5000000",
      "amount_out_estimated": "4998546",
      "created_at": "2025-10-28T17:36:29Z",
      "expires_at": null,
      "fee": {
        "fee_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
        "network_fee": "1454",
        "router_fee": "0",
        "total_fee": "1454"
      },
      "from_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
      "from_chain": "solana-devnet",
      "id": "5917c6e9-4a69-4ca4-90b8-22d9abaf3c8b",
      "min_amount_out": "4983550",
      "provider": "skipgo",
      "provider_context": {
        "route": {
          "estimated_fees": [
            {
              "amount": "1454",
              "bridge_id": "CCTP",
              "chain_id": "solana-devnet",
              "fee_type": "SMART_RELAY",
              "origin_asset": {
                "chain_id": "solana-devnet",
                "coingecko_id": "usd-coin",
                "symbol": "USDC"
              }
            }
          ],
          "estimated_route_duration_seconds": 25
        },
        "txs": [
          {
            "svm_tx": {
              "chain_id": "solana-devnet",
              "signer_address": "3DWrAUpE8DWTyEfexXHcyJzYDieyJCw7pwsSiJRcjzKx",
              "tx": "<base64-encoded Solana transaction>"
            }
          }
        ]
      },
      "to_asset": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
      "to_chain": "sepolia",
      "transactions": [
        {
          "chain_id": "EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
          "kind": "solana",
          "tx_base64": "<base64-encoded Solana transaction>"
        }
      ]
    }
  ],
  "risk": {
    "errors": [],
    "overall_risk_level": "high",
    "processing_time_ms": 4439.167,
    "request_summary": {
      "amount": 100000000,
      "recipient_address": "0x10ADD26fb2D17dA265e0567B8F56cb4687979fbE",
      "recipient_network": "ethereum",
      "recipient_token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "sender_address": "GvFbpZcqXNoZbAH8ETAA4DYBzaEHY4v2Vt7r71ZqJCTc",
      "sender_network": "solana",
      "sender_token": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    },
    "risk_factors": [
      {
        "description": "Unable to assess new wallet risk due to service error: Network 'ethereum' is not configured.",
        "factor": "assessment_error_new_wallet",
        "risk_level": "medium"
      },
      {
        "description": "Unable to assess dormant wallet risk: Network 'ethereum' is not configured.",
        "factor": "assessment_error_dormant_wallet",
        "risk_level": "medium"
      },
      {
        "description": "No address poisoning pattern detected between sender and recipient",
        "factor": "no_address_poisoning",
        "risk_level": "low"
      },
      {
        "description": "First ever interaction between these addresses",
        "factor": "first_interaction",
        "risk_level": "high"
      },
      {
        "description": "Sender address is directly connected (1 hop) to malicious addresses (riskScore: 10). Address is directly malicious.",
        "factor": "connected_to_malicious_address",
        "risk_level": "high"
      },
      {
        "description": "Recipient address has no known connections to malicious addresses according to Range API",
        "factor": "clean_address_recipient",
        "risk_level": "low"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

from_chain

enum<string>

required

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

Available options:

eth,

sepolia,

solana,

oeth,

solana-devnet,

osmosis-1,

arb1,

pol,

base,

avax,

bnb,

neutron-1,

celestia,

opsep,

fuji,

amoy,

basesep,

linea

from_address

string

Sender address on the source chain

from_asset

string

Asset/mint/contract on the source chain

to_chain

enum<string>

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

Available options:

eth,

sepolia,

solana,

oeth,

solana-devnet,

osmosis-1,

arb1,

pol,

base,

avax,

bnb,

neutron-1,

celestia,

opsep,

fuji,

amoy,

basesep,

linea

to_asset

string

Asset/mint/contract on the destination chain

amount

string

Amount in base units (integer string, no decimals)

slippage_bps

integer<int32>

required

Slippage in basis points (0..=10000)

Required range: x >= 0

to_address

string

Recipient address on the destination chain

travel_rule_compliant

boolean

Whether the transaction complies with Travel Rule requirements.

allowed_providers

enum<string>[]

If set, the router will restrict quote routing to these providers only. If omitted, all available providers will be used.

GET request usage: ?allowed_providers=relay&allowed_providers=skipgo (use repeated query parameters)

Available options:

skipgo,

debridge,

lifi,

squid,

switchain,

direct,

relay,

jupiter

risk_report

boolean

Whether this request should compute a risk report. If omitted, defaults to false.

Response

Quotes successfully retrieved.

quotes

object[]

required

All viable quotes from supported quote providers (each RouteQuote includes its provider)

Show child attributes

quotes.amount_in

string

required

Input amount in base units (integer string)

Example:

"100000000"

quotes.amount_out_estimated

string

required

Estimated output amount in base units (integer string)

Example:

"99850000"

quotes.created_at

string<date-time>

required

RFC3339 timestamp when the quote was created (UTC)

Example:

"2025-11-03T13:00:00Z"

quotes.expires_at

string<date-time> | null

required

Optional RFC3339 timestamp indicating when the quote becomes invalid (UTC).

Some providers include explicit expiry times; otherwise this field may be null. Consumers should treat quotes without this field as ephemeral and validate freshness before execution.

Example:

"2025-11-03T13:01:00Z"

quotes.from_asset

string

required

Source asset/mint/contract

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

quotes.from_chain

enum<string>

required

Source chain name

Available options:

eth,

sepolia,

solana,

oeth,

solana-devnet,

osmosis-1,

arb1,

pol,

base,

avax,

bnb,

neutron-1,

celestia,

opsep,

fuji,

amoy,

basesep,

linea

quotes.id

string<uuid>

required

Quote UUID

Example:

"b9a1b2a0-8d2b-4e4d-9e64-0e0a8f7a9d3c"

quotes.min_amount_out

string

required

Minimum guaranteed output in base units (integer string)

Example:

"99500000"

quotes.provider

enum<string>

required

Quote provider identifier (e.g., "deBridge DLN", "LI.FI")

Available options:

skipgo,

debridge,

lifi,

squid,

switchain,

direct,

relay,

jupiter

quotes.to_asset

string

required

Destination asset/mint/contract

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

quotes.to_chain

enum<string>

required

Destination chain name

Available options:

eth,

sepolia,

solana,

oeth,

solana-devnet,

osmosis-1,

arb1,

pol,

base,

avax,

bnb,

neutron-1,

celestia,

opsep,

fuji,

amoy,

basesep,

linea

quotes.fee

object

Fees, if provided by the quote provider

Show child attributes

quotes.fee.fee_asset

string

required

Asset denom or contract address of the fee currency

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

quotes.fee.network_fee

string

required

Network fee charged for the transaction, in base units (integer string)

Example:

"50000"

quotes.fee.router_fee

string

required

Quote provider fee, in base units (integer string)

Example:

"25000"

quotes.fee.total_fee

string

required

Total fee (sum of network and router fees), in base units (integer string)

Example:

"75000"

quotes.transactions

object[]

One or more chain-specific transactions required to execute this route

An EVM transaction

Option 1
Option 2
Option 3

Show child attributes

quotes.transactions.chain_id

string

required

Target chain ID (e.g. 11155111)

quotes.transactions.data

string

required

Calldata or ABI-encoded payload

quotes.transactions.kind

enum<string>

required

Available options:

eip155

quotes.transactions.to

string

required

To address

quotes.transactions.value

string

required

Value in wei

quotes.transactions.erc20_approvals

object[]

Optional list of ERC20 approvals required before execution

Show child attributes

quotes.transactions.erc20_approvals.amount

string

required

Approval amount (integer string)

Example:

"100000000"

quotes.transactions.erc20_approvals.spender

string

required

Spender contract address

Example:

"0x585F053d554B8d4c3983A7BBaDbe13B15BA66F37"

quotes.transactions.erc20_approvals.token_contract

string

required

Token contract address

Example:

"0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"

quotes.transactions.meta

any

Optional chain-specific metadata (gas, nonce, etc.)

risk

any

required

Risk assessment from the ML API (None if the call failed)

NOTE: PaymentRiskResponse is from an external crate. We keep the field typed as PaymentRiskResponse in Rust, but for OpenAPI we document it as JSON and provide a realistic example payload.

Get a quote Track transaction status

⌘I

Overview

Architecture

Integration Guide

Product Information

API Reference

Get quotes

Authorizations

Query Parameters

Response