Buy Crypto

There are 2 steps to using the Buy Crypto API:‍

1. Get a Quote to Buy Crypto (valid for 30 seconds)
2. Execute the Buy Crypto (within 30 seconds of the quote)

Step 1: Get a Quote to Buy Crypto

You can request for a quote by specifying the Quantity in the cryptocurrency or Amount in USD. There are 2 methods to get a Quote to Buy Crypto:

Method 1: Quote to Buy Crypto by Quantity (in Cryptocurrency). Quote responds with the Price in USD.

REQUEST

1. GET /v1/crypto/:id/buy/quote?cryptoCurrency=BTC&quantity=0.1
   

Where:
- :id = {{walletId}}
- cryptoCurrency = one of the cryptocurrencies supported (ex: BTC)
- quantity = quantity of the Cryptocurrency (ex: 0.1)

RESPONSE

1. {
2.     "id": "qtn-e1435a7c-c809-455e-a210-8a4b0242b48f",
3.     "cryptoCurrency": "BTC",
4.     "quotedCurrency": "USD",
5.     "quantity": "0.1",
6.     "amount": "4601.71",
7.     "price": "46017.16",
8.     "expires": "2022-04-01T01:05:21Z"
9. }

In this example: To Buy 0.1 BTC, the Amount is USD 4601.71.
In the quote API, you also get the market price for 1 quantity, in this example, 1 BTC = USD 46017.16

Method 2: Quote to Buy Crypto by Amount (in USD). Quote responds with the Quantity in Cryptocurrency.

REQUEST

1. GET /v1/crypto/:id/buy/quote?cryptoCurrency=BTC&amount=4601.71

Where:
- :id = {{walletId}}
- cryptoCurrency = one of the cryptocurrencies supported (ex: BTC)
- amount = amount in USD (ex: 4601.71)

RESPONSE

1. {
2.     "id": "qtn-e1435a7c-c809-455e-a210-8a4b0242b48f",
3.     "cryptoCurrency": "BTC",
4.     "quotedCurrency": "USD",
5.     "quantity": "0.1",
6.     "amount": "4601.71",
7.     "price": "46017.16",
8.     "expires": "2022-04-01T01:05:21Z"
9. }

In this example: For the amount of USD 4601.71, you can buy 0.1 BTC.
In the quote API, you also get the market price for 1 quantity, in this example, 1 BTC = USD 46017.16

Step 2: Execute the Buy Crypto‍
In Step 1, you get a quoteId that is valid for 30 seconds. You can execute the Buy Crypto inside the 30 seconds, else it times out and you'd need to request a new quote. In the request object, pass the quoteId, source USD account and the description.

ENDPOINT

1. POST /v1/crypto/:id/buy

REQUEST

1. {
2.     "quoteId": "{{quoteId}}",
3.     "accountId": "{{accountId}}",
4.     "description": "buy crypto"
5. }

RESPONSE

1. {
2.     "id": "cpt-7fd29184-2e12-4d11-b644-17dbf954ca8a",
3.     "title": "Crypto Buy Transfer",
4.     "description": "crypto buy one",
5.     "cryptoCurrency": "BTC",
6.     "accountId": "acc-a575f9fb-9283-4c9d-b4fc-77e3c3a36203",
7.     "walletId": "",
8.     "quotedCurrency": "USD",
9.     "quotedPrice": "45839.55",
10.     "quoteId": "qtn-2804617f-b56f-4ebd-844d-3bfafdd7aee9",
11.     "quantity": "0.00218152",
12.     "amount": "100.00",
13.     "destinationCryptoAddress": "",
14.     "gasFee": "",
15.     "txnType": "debit",
16.     "status": "completed",
17.     "createdAt": "2022-04-01T01:15:26Z",
18.     "modifiedAt": "2022-04-01T01:15:26Z",
19.     "transferredAt": "2022-04-01T01:15:26Z",
20.     "metadata": null
21. }

‍