Get a quote

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

{
  "quote": {
    "amount_in": "5000000",
    "amount_out_estimated": "5000000",
    "created_at": "2025-10-29T10:01:23Z",
    "expires_at": null,
    "fee": {
      "fee_asset": "",
      "network_fee": "5000",
      "router_fee": "",
      "total_fee": ""
    },
    "from_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
    "from_chain": "solana-devnet",
    "id": "0575d7f5-7e02-4208-a993-7261e605c470",
    "min_amount_out": "5000000",
    "provider": "direct",
    "provider_context": null,
    "to_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
    "to_chain": "solana-devnet",
    "transactions": [
      {
        "chain_id": "EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
        "kind": "solana",
        "meta": {
          "blockhash_expiry_seconds": 120,
          "decimals": 6,
          "from_ata": "B4G1X1UoWXNy6HXk2MXRhbSY3Sd2z8Mf32Ak9zC7XG62",
          "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "recent_blockhash": "AHhbjisxx4vtWhiQ22gQUFoJtzdT3ad22XzXhuHrBLca",
          "requires_create_ata": true,
          "to_ata": "5QTxbuHroxQM7rv1vSzMMvUQ2a3vJodtQH9vawKTATGd"
        },
        "tx_base64": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAUIIOwXp6hCF/z4mI2gcyShGCThUvUeWCz+ZW2xfiXSYc9BcZarum/U3+JSrWwNCxzVBJ35PgfnhqGFrgcRv2U2epVqlROnrjt2WjMsC9+l+jYSO/jqh6sTObfeI8b6DLRvAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqTtELLORIVfxOpM9ATQoLQMrX/7NAaLb8bd5BgjfAC6nY959WgOStnuBoC8tRC/LcM5DR1JIURG+4DuXI98XF5iMlyWPTiSJ8bs9ECkUjg2DC1oTmdr/EIQEjnvY2+n4WYoAYW/SC9NKD87MwG5xFBtjx3eWhiQkhmWpP8npFuJbAgcGAAEGBQMEAQEEBAIFAQAKDEBLTAAAAAAABg=="
      }
    ]
  },
  "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"
      }
    ]
  }
}

Transactions

Get a 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).

GET

transactions

quote

Get a quote

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

{
  "quote": {
    "amount_in": "5000000",
    "amount_out_estimated": "5000000",
    "created_at": "2025-10-29T10:01:23Z",
    "expires_at": null,
    "fee": {
      "fee_asset": "",
      "network_fee": "5000",
      "router_fee": "",
      "total_fee": ""
    },
    "from_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
    "from_chain": "solana-devnet",
    "id": "0575d7f5-7e02-4208-a993-7261e605c470",
    "min_amount_out": "5000000",
    "provider": "direct",
    "provider_context": null,
    "to_asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
    "to_chain": "solana-devnet",
    "transactions": [
      {
        "chain_id": "EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
        "kind": "solana",
        "meta": {
          "blockhash_expiry_seconds": 120,
          "decimals": 6,
          "from_ata": "B4G1X1UoWXNy6HXk2MXRhbSY3Sd2z8Mf32Ak9zC7XG62",
          "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "recent_blockhash": "AHhbjisxx4vtWhiQ22gQUFoJtzdT3ad22XzXhuHrBLca",
          "requires_create_ata": true,
          "to_ata": "5QTxbuHroxQM7rv1vSzMMvUQ2a3vJodtQH9vawKTATGd"
        },
        "tx_base64": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAUIIOwXp6hCF/z4mI2gcyShGCThUvUeWCz+ZW2xfiXSYc9BcZarum/U3+JSrWwNCxzVBJ35PgfnhqGFrgcRv2U2epVqlROnrjt2WjMsC9+l+jYSO/jqh6sTObfeI8b6DLRvAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqTtELLORIVfxOpM9ATQoLQMrX/7NAaLb8bd5BgjfAC6nY959WgOStnuBoC8tRC/LcM5DR1JIURG+4DuXI98XF5iMlyWPTiSJ8bs9ECkUjg2DC1oTmdr/EIQEjnvY2+n4WYoAYW/SC9NKD87MwG5xFBtjx3eWhiQkhmWpP8npFuJbAgcGAAEGBQMEAQEEBAIFAQAKDEBLTAAAAAAABg=="
      }
    ]
  },
  "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

Quote successfully retrieved.

quote

object

required

The selected best route/quote

Show child attributes

quote.amount_in

string

required

Input amount in base units (integer string)

Example:

"100000000"

quote.amount_out_estimated

string

required

Estimated output amount in base units (integer string)

Example:

"99850000"

quote.created_at

string<date-time>

required

RFC3339 timestamp when the quote was created (UTC)

Example:

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

quote.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"

quote.from_asset

string

required

Source asset/mint/contract

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

quote.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

quote.id

string<uuid>

required

Quote UUID

Example:

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

quote.min_amount_out

string

required

Minimum guaranteed output in base units (integer string)

Example:

"99500000"

quote.provider

enum<string>

required

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

Available options:

skipgo,

debridge,

lifi,

squid,

switchain,

direct,

relay,

jupiter

quote.to_asset

string

required

Destination asset/mint/contract

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

quote.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

quote.fee

object

Fees, if provided by the quote provider

Show child attributes

quote.fee.fee_asset

string

required

Asset denom or contract address of the fee currency

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

quote.fee.network_fee

string

required

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

Example:

"50000"

quote.fee.router_fee

string

required

Quote provider fee, in base units (integer string)

Example:

"25000"

quote.fee.total_fee

string

required

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

Example:

"75000"

quote.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

quote.transactions.chain_id

string

required

Target chain ID (e.g. 11155111)

quote.transactions.data

string

required

Calldata or ABI-encoded payload

quote.transactions.kind

enum<string>

required

Available options:

eip155

quote.transactions.to

string

required

To address

quote.transactions.value

string

required

Value in wei

quote.transactions.erc20_approvals

object[]

Optional list of ERC20 approvals required before execution

Show child attributes

quote.transactions.erc20_approvals.amount

string

required

Approval amount (integer string)

Example:

"100000000"

quote.transactions.erc20_approvals.spender

string

required

Spender contract address

Example:

"0x585F053d554B8d4c3983A7BBaDbe13B15BA66F37"

quote.transactions.erc20_approvals.token_contract

string

required

Token contract address

Example:

"0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"

quote.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.

Create a transaction Get quotes

⌘I

Overview

Architecture

Integration Guide

Product Information

API Reference

Get a quote

Authorizations

Query Parameters

Response