Die Onramp Quotes API verwendenBeta
Zeigen Sie Angebote in der Nutzeroberfläche Ihres Produkts an.
Mit der Onramp Quotes API können Plattformen geschätzte Angebote für Onramp-Konvertierungen in verschiedenen Kryptowährungen in verschiedenen Netzwerken abrufen. Sie können einen festen Quell- oder Zielbetrag angeben und die Notierungen auf eine Untergruppe von Zielwährungen oder -netzen beschränken. Mit der API können Sie Angebote in der Nutzeroberfläche Ihres Produkts anzeigen, bevor die Nutzer/innen zum Nutzeroberfläche-Widget weitergeleitet werden. Wenn das Angebot abgelaufen ist, bevor der/die Nutzer/in das Onramp-Widget aufruft, wird dem/der Nutzer/in möglicherweise ein etwas anderes Angebot im Onramp-Widget angezeigt.
Konvertierungsangebot anfordern
Verwenden Sie den Endpoint GET /v1/crypto/onramp_, um ein Konvertierungsangebot zu erhalten. Die folgende Tabelle enthält alle verfügbaren Parameter für diesen Endpoint:
| Parameter | Typ | Standard | Details |
|---|---|---|---|
source_ | Zeichenfolge (optional) | usd | Der Währungscode ISO-4217. Wir unterstützen derzeit nur usd und eur. |
source_ | Zeichenfolge (optional) | 100. | Eine Zeichenfolgendarstellung des Fiat-Betrags, den Sie für die Onramp benötigen. Wenn source_ festgelegt ist, muss destination_ null sein (diese schließen sich gegenseitig aus, da Sie lediglich einen festen Betrag für ein Ende des Handels festlegen können). |
destination_ | Zeichenfolge (optional) | null | Eine Zeichenfolgendarstellung des Betrags der destination_, der gekauft wird. Wenn destination_ festgelegt ist, muss source_ null sein. Wenn Sie dieses Feld angeben, müssen Sie außerdem jeweils einen Wert für destination_ und einen Wert für destination_ festlegen (dadurch wissen wir, für welche Kryptowährung ein Angebot gemacht wird). |
destination_ | Array<String> (optional) | null
| Die Liste der Kryptowährungen, für die Sie Angebote generieren möchten. Wenn null gelassen wird, rufen wir Angbote für alle destination_ ab, die destination_ unterstützt.
|
destination_ | Array<String> (optional) | null
| Die Liste der Kryptowährungsnetzwerke, für die Sie Angebote erstellen möchten. Wenn null gelassen wird, rufen wir Angebote für destination_ in allen Netzwerken ab.
|
Beispiel für Angebotsanfragen
Führen Sie den folgenden Befehl aus, um alle Währungs-Netzwerk-Zielpaare mit einem Standard-Quellbetrag von 100 USD abzurufen:
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ -u:sk_test_4eC39HqLyjWDarjtT1zdp7dc
Sie erhalten eine Antwort ähnlich der folgenden:
{ "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" }
Führen Sie den folgenden Befehl aus, um alle Währungs-Netzwerk-Zielpaare mit einem Quellbetrag von 200 USD abzurufen:
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ -u: \ -d "source_amount"="200"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Sie erhalten eine Antwort ähnlich der folgenden:
{ "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" }
Führen Sie den folgenden Befehl aus, um Angebote für ETH und SOL in den Ethereum- und Solana-Netzwerken abzurufen (das Ergebnis ist ETH auf Ethereum und SOL auf Solana). Wenn Sie destination_ und destination_ angeben, wird für jedes gültige Währungs-Netzwerk-Paar ein Angebot ermittelt. Der Standardwert für destination_ ist alle Währungen und der Standardwert für destination_ ist alle Netzwerke.
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
Sie erhalten eine Antwort ähnlich der folgenden:
{ "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" }
Führen Sie den folgenden Befehl aus, um Angebote für USDC auf Ethereum und Solana abzurufen:
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
Sie erhalten eine Antwort ähnlich der folgenden:
{ "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" }
Führen Sie den folgenden Befehl aus, um ein Angebot für ein einzelnes Währungs-Netzwerk-Zielpaar (ETH auf Ethereum) mit dem angegebenen destination_ abzurufen:
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
Sie erhalten eine Antwort ähnlich der folgenden:
{ "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" }