API QuotesBêta
L’API Quotes permet aux plateformes de récupérer des devis estimatifs pour les conversions de la rampe d’accès dans les différentes cryptomonnaies sur les différents réseaux concernés. Vous pouvez spécifier un montant source ou cible fixe et également limiter les devis à un sous-ensemble de devises ou de réseaux cibles. L’API Quotes vous permet d’afficher les devis dans l’interface utilisateur de votre produit avant de rediriger l’utilisateur vers le widget de la rampe d’accès. Si le devis expire avant que l’utilisateur n’ait accédé au widget, un devis légèrement différent pourra s’afficher dans le widget de la rampe d’accès.
Obtenir un devis
Endpoint : GET /v1/crypto/onramp_quotes
Nom du paramètre | Type (facultatif ?) par défaut : ? | Détails |
---|---|---|
source_currency | Chaîne (facultatif) par défaut : usd | Le code de devise ISO-4217 . À l’heure actuelle, nous prenons uniquement en charge usd . |
source_amount | Chaîne (facultatif) par défaut : 100.00 | Représentation sous forme de chaîne du montant fiduciaire à prendre en compte pour la conversion. Si source_amount est défini, destination_amount doit être nul (les deux paramètres s’excluent mutuellement, car vous ne pouvez définir un montant fixe que pour un côté de la transaction). |
destination_amount | Chaîne (facultatif) par défaut : null | Représentation sous forme de chaîne du montant de destination_currency à acheter. Si destination_amount est défini, source_amount doit être nul. Lorsque vous renseignez ce champ, vous devez également définir une valeur unique pour destination_currencies et une valeur unique pour destination_networks (afin que nous sachions quelle cryptomonnaie coter). |
destination_currencies | Tableau<String> (facultatif) par défaut : null
| Liste des cryptomonnaies pour lesquelles vous souhaitez générer des devis. Si la valeur est nulle, nous récupérons des devis pour toutes les destination_currencies prises en charge par destination_networks .
|
destination_networks | Tableau<String> (facultatif) par défaut : null
| Liste des réseaux de cryptomonnaies pour lesquels vous souhaitez générer des devis. Si la valeur est nulle, nous récupérons des devis pour destination_currencies sur tous les réseaux.
|
La section suivante fournit des exemples de requêtes avec différents paramètres.
Exemples de requêtes
Requête curl de base avec paramètres spécifiés qui récupère toutes les paires devise-réseau cibles avec un montant source par défaut de 100 USD.
Requête :
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc
Réponse :
{ "id": "cd35838481497f403988360cc0ff5ce5c5ce7451ce8938f86d379dff7157d33d", "rate_fetched_at": 1674265380.6883376, "destination_network_quotes": { "ethereum": [ { "id": "7eb9ccb7c1bffadf3773ca1f56ba3a352fe4a226328e72142925a80e7242b70c", "destination_currency": "eth", "destination_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_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_amount": "100.00" }
Récupération de toutes les paires devise-réseau cibles avec un montant source de 200 USD
Requête :
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ -u
: \ -d "source_amount"="200"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Réponse :
{ "id": "2e5818944df6a2325c7e9c1e72d27174b9bedfc8e64ace47c081370a5b982a7b", "rate_fetched_at": 1674265506.3408287, "destination_network_quotes": { "ethereum": [ { "id": "d160a80828eabb6b6d4aeafac585eee62d95425c7fb7577866ab04b9a786df00", "destination_currency": "eth", "destination_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_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_amount": "200.00" }
Récupération de devis pour ETH et SOL sur les réseaux Ethereum et Solana (se terminant par ETH sur Ethereum et SOL sur Solana). Lorsque destination_currencies
et destination_networks
sont spécifiés, chaque paire devise-réseau dans leur produit croisé est prise en compte et renvoie un devis si la paire est valide. La valeur par défaut pour destination_currencies
correspond à toutes les devises et la valeur par défaut pour destination_networks
correspond à tous les réseaux.
Requête :
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ -u
: \ -d "source_amount"="200" \ -d "destination_currencies[]"="eth" \ -d "destination_currencies[]"="sol" \ -d "destination_networks[]"="ethereum" \ -d "destination_networks[]"="solana"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Réponse :
{ "id": "c9ab6fd14f87290ef94b583f0dd346de8e197321e029776c12b7790cd83fb78c", "rate_fetched_at": 1674265576.8238478, "destination_network_quotes": { "bitcoin": [], "ethereum": [ { "id": "97bbd7b9f8bc1a029264cdc28b47b636e989f8bcab96a80a3bded2094131e311", "destination_currency": "eth", "destination_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_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_amount": "200.00" }
Récupération de devis pour l’USDC sur Ethereum et Solana.
Requête :
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ -u
: \ -d "source_amount"="200" \ -d "destination_currencies[]"="usdc" \ -d "destination_networks[]"="ethereum" \ -d "destination_networks[]"="solana"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Réponse :
{ "id": "8727e8de9a22915aea079973028054e31d362a328758a5953cee6ba1b6f22569", "rate_fetched_at": 1674268717.432479, "destination_network_quotes": { "bitcoin": [], "ethereum": [ { "id": "603f29933c921d59b169572cf2d61da7d88f2a6973da0d6fcb686b3dec3de223", "destination_currency": "usdc", "destination_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_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_amount": "200.00" }
Récupération d’une cote pour une paire devise-réseau cible (ETH sur Ethereum) avec destination_amount
spécifié.
Requête :
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ -u
: \ -d "destination_amount"="0.42" \ -d "destination_currencies[]"="eth" \ -d "destination_networks[]"="ethereum"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Réponse :
{ "id": "74f73859a8836293ce4f1e6757dc258c9f1016deea7b075faba8b5755d163168", "rate_fetched_at": 1674268804.6989243, "destination_network_quotes": { "bitcoin": null, "ethereum": [ { "id": "f1adad5680b081031b03b89c174d25ce6b609416fc82f976423e95a089a10334", "destination_currency": "eth", "destination_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_amount": "697.02" }