Sign in
An image of the Stripe logo
Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
No-code
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Issuing cards
Crypto
    Fiat-to-crypto onramp
      Overview
      Quickstart
      Integrate the onramp
      Using the API
      Integration recipes
      Mobile Integration
      Quotes API
      ES Module
    Crypto payouts
Treasury
Business financing
HomeFinancial servicesCryptoFiat-to-crypto onramp

Quotes API

Learn how to use the onramp quotes API.

The Quotes API allows platforms to fetch estimated quotes for onramp conversions into all the different cryptocurrencies on different networks. You can specify a fixed source or destination amount and also limit the quotes to a subset of destination currencies or networks. The Quotes API allows you to display quotes in your product UI before directing the user to the onramp widget. If the quote has expired before the user visits the onramp widget, the user might see a slightly different quote in the onramp widget.

Get quote

Endpoint: GET /v1/crypto/onramp/quotes

Parameter nameType (optional?) default: ?Details
source_currencyString (optional) default: usdThe ISO-4217 Currency code. We only support usd currently.
source_exchange_amountString (optional) default: 100.00A string representation of the fiat amount that you need to onramp. If source_exchange_amount is set, destination_exchange_amount must be null (they’re mutually exclusive because you can only set a fixed amount for one end of the trade).
destination_exchange_amountString (optional) default: nullA string representation of the amount of destination_currency to be purchased. If destination_exchange_amount is set, source_exchange_amount must be null. When specifying this field, you must also set a single value for destination_currencies and a single value for destination_networks (so we know what cryptocurrency to quote).
destination_currenciesArray<String> (optional) default: null
  • ['usdc', 'ethereum']
The list of cryptocurrencies you want to generate quotes for. If left null, we retrieve quotes for all destination_currencies that destination_networks supports.
  • Currencies: btc, eth, sol, matic, usdc
destination_networksArray<String> (optional) default: null
  • ['polygon', 'bitcoin', 'solana', 'ethereum']
The list of cryptocurrency networks you want to generate quotes for. If left null, we retrieve quotes for destination_currencies in all networks.
  • Networks: bitcoin, ethereum, solana, polygon

The following section shows example requests with a variety of different parameters.

Example requests

A basic curl request with parameters specified that fetches all destination currency-network pairs with a default source amount of 100 USD.

Request:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:

Response:

Command Line
{ "id": "cd35838481497f403988360cc0ff5ce5c5ce7451ce8938f86d379dff7157d33d", "rate_fetched_at": 1674265380.6883376, "destination_network_quotes": { "ethereum": [ { "id": "7eb9ccb7c1bffadf3773ca1f56ba3a352fe4a226328e72142925a80e7242b70c", "destination_currency": "eth", "destination_exchange_amount": "0.060232255577506866", "destination_network": "ethereum", "fees": { "network_fee_monetary": "1.41", "transaction_fee_monetary": "3.03" }, "source_total_amount": "104.44" }, { "id": "398de047128b6dff1abbc41519811db68dd8bcb69939b87c4a4621b1740a1c5b", "destination_currency": "usdc", "destination_exchange_amount": "100.00", "destination_network": "ethereum", "fees": { "network_fee_monetary": "5.63", "transaction_fee_monetary": "3.07" }, "source_total_amount": "108.70" } ], ... }, "livemode": true, "source_currency": "usd", "source_exchange_amount": "100.00" }

Fetching all destination currency-network pairs with a source amount of 200 USD

Request:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "source_exchange_amount"="200"

Response:

Command Line
{ "id": "2e5818944df6a2325c7e9c1e72d27174b9bedfc8e64ace47c081370a5b982a7b", "rate_fetched_at": 1674265506.3408287, "destination_network_quotes": { "ethereum": [ { "id": "d160a80828eabb6b6d4aeafac585eee62d95425c7fb7577866ab04b9a786df00", "destination_currency": "eth", "destination_exchange_amount": "0.253568242640499553", "destination_network": "ethereum", "fees": { "network_fee_monetary": "1.45", "transaction_fee_monetary": "12.71" }, "source_total_amount": "214.20" }, { "id": "53f864cb28a42f11e1d9d5aff7e43ac96b056406f74cbf618399c6fa40f3d275", "destination_currency": "usdc", "destination_exchange_amount": "200.00", "destination_network": "ethereum", "fees": { "network_fee_monetary": "5.80", "transaction_fee_monetary": "12.76" }, "source_total_amount": "218.56" } ], ... }, "livemode": true, "source_currency": "usd", "source_exchange_amount": "200.00" }

Fetching quotes for ETH and SOL on the Ethereum and Solana networks (which ends up being ETH on Ethereum and SOL on Solana). When destination_currencies and destination_networks are specified, each currency-network pair in their cross-product is considered, and returns a quote if the pair is valid. The default value for destination_currencies is all currencies and the default value for destination_networks is all networks.

Request:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "source_exchange_amount"="200" \ -d "destination_currencies[]"="eth" \ -d "destination_currencies[]"="sol" \ -d "destination_networks[]"="ethereum" \ -d "destination_networks[]"="solana"

Response:

Command Line
{ "id": "c9ab6fd14f87290ef94b583f0dd346de8e197321e029776c12b7790cd83fb78c", "rate_fetched_at": 1674265576.8238478, "destination_network_quotes": { "bitcoin": [], "ethereum": [ { "id": "97bbd7b9f8bc1a029264cdc28b47b636e989f8bcab96a80a3bded2094131e311", "destination_currency": "eth", "destination_exchange_amount": "0.253433817682353791", "destination_network": "ethereum", "fees": { "network_fee_monetary": "1.46", "transaction_fee_monetary": "12.71" }, "source_total_amount": "214.17" } ], "polygon": [], "solana": [ { "id": "79f00923b96543aa69d140172c7cefd0e73a2ed089d8935e63dcf21028698e23", "destination_currency": "sol", "destination_exchange_amount": "16.767237943", "destination_network": "solana", "fees": { "network_fee_monetary": "0.01", "transaction_fee_monetary": "12.70" }, "source_total_amount": "212.71" } ] }, "livemode": true, "source_currency": "usd", "source_exchange_amount": "200.00" }

Fetching quotes for USDC on Ethereum and Solana.

Request:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "source_exchange_amount"="200" \ -d "destination_currencies[]"="usdc" \ -d "destination_networks[]"="ethereum" \ -d "destination_networks[]"="solana"

Response:

Command Line
{ "id": "8727e8de9a22915aea079973028054e31d362a328758a5953cee6ba1b6f22569", "rate_fetched_at": 1674268717.432479, "destination_network_quotes": { "bitcoin": [], "ethereum": [ { "id": "603f29933c921d59b169572cf2d61da7d88f2a6973da0d6fcb686b3dec3de223", "destination_currency": "usdc", "destination_exchange_amount": "200.00", "destination_network": "ethereum", "fees": { "network_fee_monetary": "5.88", "transaction_fee_monetary": "12.76" }, "source_total_amount": "218.64" } ], "polygon": [], "solana": [ { "id": "38b8388072e6272e7a0c0d5ee1161d3d747362a574f54fe76f1554ff60e3a007", "destination_currency": "usdc", "destination_exchange_amount": "200.00", "destination_network": "solana", "fees": { "network_fee_monetary": "0.01", "transaction_fee_monetary": "12.70" }, "source_total_amount": "212.71" } ] }, "livemode": true, "source_currency": "usd", "source_exchange_amount": "200.00" }

Fetching a quote for a single destination currency-network pair (ETH on Ethereum) with destination_exchange_amount specified.

Request:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "destination_exchange_amount"="0.42" \ -d "destination_currencies[]"="eth" \ -d "destination_networks[]"="ethereum"

Response:

Command Line
{ "id": "74f73859a8836293ce4f1e6757dc258c9f1016deea7b075faba8b5755d163168", "rate_fetched_at": 1674268804.6989243, "destination_network_quotes": { "bitcoin": null, "ethereum": [ { "id": "f1adad5680b081031b03b89c174d25ce6b609416fc82f976423e95a089a10334", "destination_currency": "eth", "destination_exchange_amount": "0.420000000000000000", "destination_network": "ethereum", "fees": { "network_fee_monetary": "1.45", "transaction_fee_monetary": "21.06" }, "source_total_amount": "719.53" } ], "polygon": null, "solana": null }, "livemode": true, "source_currency": "usd", "source_exchange_amount": "697.02" }
Was this page helpful?
Questions? Contact us.
Watch our developer tutorials.
Check out our product changelog.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
Stripe Shell
Test mode
Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Login to your Stripe account and press Control + Backtick on your keyboard to start managing your Stripe resources in test mode. - View supported Stripe commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$