In this article, you will learn how to receive an SMS using RingCentral when a user Bitcoin Vault price goes up more than US $10 or down more than US $10.
Introduction
tl;dr: This is not a post for mining bitcoin using the RingCentral SMS app, I intend to use their SMS API to get a notification when a certain cryptocurrency changes price.
I decided to start learning about new cryptocurrencies and invest in digital markets. There is a particular new crypto called Bitcoin Vault that caught my attention.
It is a new and completely decentralized cryptocurrency that is part of the Decentralized Digital Mining Standard with new anti-theft solutions, already available in three exchanges. I started mining it at miningcity.com.
I want to keep a constant eye on its current price, so I want to be informed when the price changes. I decided to create a script that will send me a SMS using Ring Central’s API whenever the current price varies more than $10 usd (up or down) comparing it with the last price checked.
Using the Code
We are going to need the following tools:
Steps
1. Create a CoinMarketCap API
I use coinmarketcap to check the price of a cryptocurrency, so head to https://coinmarketcap.com/api/ and create a new developer free account.
2. PHP Script
For this test, I created a folder named RingCentral, and added a PHP file named cryptoCurrency.php.
Open your empty file and copy these lines of code:
<?php
$url = 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/map';
$parameters = [
'symbol' => 'BTC,BTCV'
];
$headers = [
'Accepts: application/json',
'X-CMC_PRO_API_KEY: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c'
];
$qs = http_build_query($parameters);
$request = "{$url}?{$qs}";
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $request,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => 1
));
$response = curl_exec($curl);
print_r(json_decode($response));
curl_close($curl);
?>
In this example, we are using the /map
endpoint.
Make sure to use your own API KEY or it won’t work, run the script, and you will fetch all data related to the symbols sent in the payload parameters: 'symbol' => 'BTC,BTCV'
.
In this example, we can see data for the Bitcoin and Bitcoin Vault currency. This is useful because the API recommends using the internal id instead of the symbol or name.
Now that we have the id (5175) for Bitcoin Vault, let’s use the endpoint that will fetch the current price: /v1/cryptocurrency/quotes/latest.
Copy the following script:
<?php
$url = 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest';
$parameters = [
'id' => '5175'
];
$headers = [
'Accepts: application/json',
'X-CMC_PRO_API_KEY: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c'
];
$qs = http_build_query($parameters);
$request = "{$url}?{$qs}";
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $request,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => 1
));
$response = curl_exec($curl);
$result = json_decode($response,true);
print_r($result['data']['5175']['quote']['USD']);
curl_close($curl);
This will print the only part of the response that I am interested in, the price:
In order to compare the price, we need to at least have a starting point to compare, so we have to create a file where we are going to save the current price.
Create a file called currentBitcoinVaultValue.txt and add the value of 10
.
What we are going to do is add to our script a code that will read the current value in the file, and then update it with the current bitcoin vault price read from the API.
Copy the following script that will read the current price of BitcoinVault
and save it to the .txt file:
<?php
$url = 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest';
$parameters = [
'id' => '5175'
];
$headers = [
'Accepts: application/json',
'X-CMC_PRO_API_KEY: b5f708a1-3c63-4152-9e37-3a4a883e3820'
];
$qs = http_build_query($parameters);
$request = "{$url}?{$qs}";
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $request,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => 1
));
$response = curl_exec($curl);
$result = json_decode($response,true);
$currentBitcoinVaultPrice = $result['data']['5175']['quote']['USD']['price'];
curl_close($curl);
$fileName = 'currentBitcoinVaultValue.txt';
$processFile = fopen($fileName, "r") or die("Unable to open file!");
$oldPrice = fgets($processFile);
file_put_contents($fileName, $currentBitcoinVaultPrice);</code>
My current .txt file now has been updated with the current BitcoinVault
price
3. Add Ring Central’s SMS API to Our Script
Now let’s continue with the fun part, get an alert when the price has changed. For this tutorial, I want to know when the prices has gone USD 10 up or USD 10 down. So let’s add the Ring Central SMS API first.
Again, I won’t go into details on how to setup an account with Ring Central. You can follow step by step on this post, check step 5 (Setup RingCentral SMS API). It is pretty easy and quick to get a developer account.
Let’s add RingCentral’s API, your script should look like this:
<?php
require('vendor/autoload.php');
$url = 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest';
$parameters = [
'id' => '5175'
];
$headers = [
'Accepts: application/json',
'X-CMC_PRO_API_KEY: <code>b5f708a1-3c63-4152-9e37-3a4a883e3820</code>'
];
$qs = http_build_query($parameters);
$request = "{$url}?{$qs}";
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $request,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => 1
));
$response = curl_exec($curl);
$result = json_decode($response,true);
$currentBitcoinVaultPrice = $result['data']['5175']['quote']['USD']['price'];
curl_close($curl);
$fileName = 'currentBitcoinVaultValue.txt';
$processFile = fopen($fileName, "r") or die("Unable to open file!");
$oldPrice = fgets($processFile);
file_put_contents($fileName, $currentBitcoinVaultPrice);
$calc = (float)$currentBitcoinVaultPrice - (float)$oldPrice;
if ($calc >= 10)
{
smsRingCentralAlert('Bitcoin Vault has gone up to '.$currentBitcoinVaultPrice);
}
if($calc <= -10)
{
smsRingCentralAlert('Bitcoin Vault has gone down to '.$currentBitcoinVaultPrice);
}
function smsRingCentralAlert($message)
{
$RECIPIENT = 'YOUR-TEST-PHONE-NUMBER';
$RINGCENTRAL_CLIENTID = '<code>YOUR-</code>CLIENT-ID';
$RINGCENTRAL_CLIENTSECRET = '<code>YOUR-SECRE</code>T';
$RINGCENTRAL_SERVER = 'https://platform.devtest.ringcentral.com';
$RINGCENTRAL_USERNAME = 'YOUR-USERNAME';
$RINGCENTRAL_PASSWORD = '<code>YOUR-</code>PASSWORD';
$RINGCENTRAL_EXTENSION = 'YOUR-EXTENSION';</code>
$rcsdk = new RingCentral\SDK\SDK
($RINGCENTRAL_CLIENTID, $RINGCENTRAL_CLIENTSECRET, $RINGCENTRAL_SERVER);
$platform = $rcsdk->platform();
$platform->login($RINGCENTRAL_USERNAME, $RINGCENTRAL_EXTENSION, $RINGCENTRAL_PASSWORD);
$platform->post('/account/~/extension/~/sms',
[
'from' => ['phoneNumber' => $RINGCENTRAL_USERNAME],
'to' => [['phoneNumber' => $RECIPIENT]],
'text' => $message
]
);
}
Remember to use your own API keys.
I made a couple examples using a lower and a greater price to test the script. Here are my test results:
4. Final Step Cron Job
In the last tutorial, I explained what a cron job is, and how to set it up. You can take a look at all the details here.
For this example, I will create a cron job that will trigger our script every hour.
To create a cron job, just open your CLI and type:
crontab -e
Make sure to check your current path to your PHP EXE. This command will help:
whereis php
The PHP path is usually:
/usr/bin/php
After you run the crontab
, most likely an editor will open, this is an example of the cron I used for this example that will run every hour:
0 */1 * * *. /usr/bin/php /Users/juan/DEV/RingCentral/cryptoCurrency.php >
/tmp/stdout.log 2>/tmp/stderr.log
You can change the timing for the cron job, and also change the id for the currency that you want to check the price for.
History
- 19th May, 2020: Initial version