conversao-crypto-rodrigo v1.3.1
Using the library
You can basically use this library for two things:
Check the quote on any crypto currency in the world, this basic quote is given to you in USD (United States Dollar).
Convert one specific crypto currency into one, or many others.
Installing the library
To install the library, all you have to do is run the following shell command in the root of your project:
npm install conversao-crypto-rodrigo
Importing it into your project
Just like any other lib, you must import it into your project in order to use it, we do it as follows:
const cryptoConversor = require('conversa-crypto-rodrigo');
Just so we are clear, you can give it any name when you import it, cryptoConversor
was just an example.
Getting a currency's quote in USD
Now that you've installed and imported the lib into your project, you can use the quote
method giving it all the symbols of the currencies you wanna quote. In the example below, I wanna quote the values of 1 bitcoin e 1 etherium, in USD:
const currenciesQuotes = cryptoConversor.quote(['BTC', 'ETH'])
Running this, just like that, might give you the following error:
{ error: 'BTC was not found or missing SECRET_API_KEY on .env file'}
If you get this error, it prabibly means you haven't added your secret API key to a .env
file. So go ahead and create a .env
file. Inside it, you should have the value of your secret API key, which can be obtained here.
Once you have created an account and/or logged in, you should be able to have access to the key, now all you have to do is add to the file like this:
SECRET_API_KEY="YOUR_SECRET_KEY"
It is safer if you put all of your key in between quotes. Done, all yout major configuration is now good to go! A successfull response for the lib, should look like this:
[
{
id: 1,
name: 'Bitcoin',
symbol: 'BTC',
slug: 'bitcoin',
date_added: '2013-04-28T00:00:00.000Z',
last_updated: '2022-02-15T09:34:00.000Z',
quotes: [Object]
},
{
id: 1027,
name: 'Ethereum',
symbol: 'ETH',
slug: 'ethereum',
date_added: '2015-08-07T00:00:00.000Z',
last_updated: '2022-02-15T09:34:00.000Z',
quotes: [Object]
}
]
The quotes
object contains all the information regarding the USD values of that crypto.
Note
This lib relies on an API request, so it should be use in an async
function, otherwise you will receive only promises and not the real results!
Converting one crypto into one or many others
For that, all you have to do is use the conversion
method in the cryptoConversor
object. You must give it the origin crypto's symbol, the amount you want to convert, and an array with all the cryptos you want it to the be converted to.
So lets assume I want to figure out how much Etherium and Tether are 3 bitcoins worth, I would use the method like this:
const currenciesConversion = cryptoConversor.conversion('BTC', 3, ['ETH','USDT']);
The successfull result should look like this:
{
id: 1,
symbol: 'BTC',
name: 'Bitcoin',
amount: 3,
last_updated: '2022-02-15T09:59:00.000Z',
quotes: [ [Object], [Object] ]
}
In the quotes key of the response we have the two objects with the corresponding conversions.
Note:
You must keep in mind that both methods require an SECRET_API_KEY
in the .env file (as mentioned before), and both methods have asynchronous responses, so you shoud use async
and await
.