tipcc.js v1.0.1
tip.cc API Client
Welcome to the tip.cc API Client npm package!
Installation
Simply create an npm project if you don't have an already, and install the package.
npm init
npm i tipcc.js
Getting Started
Tip: Want to get started without an introduction? Check out our documentation.
You can create a simple TipccClient like this:
import { TipccClient } from 'tipcc.js';
const client = TipccClient(myToken);
client.on('ready', () => {
console.log('TipccClient is ready!');
});
myToken
is your tip.cc API key.
A note on API values
The tip.cc API uses the smallest denomination of currencies, giving values in atomic units. For an explanation of how this works, use Ethereum's wei as an example.
tipcc.js uses the bignumber.js package to handle these numbers, and our API will return these in multiple functions.
For a in-depth explanation of BigNumbers and available features, check their own documentation.
Wallets
To get your balance on tip.cc, use the WalletManager:
client.on('ready', async () => {
const wallet = await client.wallets.fetch('BNB');
if (!wallet) {
return console.log('No BNB wallet found. Have you received any BNB?');
}
console.log(
`We've got ${wallet.balance.value} ${wallet.code} on our BNB wallet`,
);
console.log(`This is approximately ${wallet.balance.usdValue} USD`);
});
Transactions
To receive transactions as events, use TransactionManager's events:
client.transactions.on('tip', (transaction) => {
const readableAmount = transaction.amount.value;
const currencyCode = transaction.amount.currencyCode;
const sender = transaction.sender.username;
console.log(`Received ${readableAmount} ${currencyCode} from ${sender}`);
});
You can also get a single or many transactions by id:
client.on('ready', async () => {
const oneTransaction = await client.transactions.fetch('one-id');
const manyTransactions = await client.transactions.fetchMany([
'this-id',
'another-id',
]);
});
Getting transactions based on a filter is also possible:
client.on('ready', async () => {
const transactionsByFilter = await client.transactions.fetchAll({
currency: 'BTC',
limit: 5,
});
});
Using no filter will get all transactions for the bot/user. This is not recommended, unless you know what you're doing.
Exchange rates
Use the ExchangeRateCache to get exchange rates:
client.on('ready', async () => {
const rate = client.exchangeRates.get('BTC');
if (!rate) {
console.log('The rate for BTC could not be found.');
}
console.log(`1 BTC is currently worth ${rate?.usdValue?.value} USD`);
});
This is also accessible on other structures, such as wallets:
client.on('ready', async () => {
const wallet = await client.wallets.fetch('BTC');
if (!wallet) {
return console.log('No BTC wallet found. Have you received any BTC?');
}
console.log(`1 BTC is now worth ${wallet.exchangeRate.usdValue} USD`);
});
Currencies
The client provides caches for cryptocurrencies (CryptocurrencyCache) and fiats (FiatCache).
This may be useful when you need some basic information about a currency.
Getting a cryptocurrency:
client.on('ready', async () => {
const btc = client.cryptos.get('BTC');
if (!btc) {
return console.log('Could not find BTC in the cache.');
}
console.log(`BTC's full name is ${btc.name}`);
console.log(`BTC's explorer is ${btc.explorer}`);
});
Getting a fiat:
client.on('ready', async () => {
const usd = client.fiats.get('USD');
if (!usd) {
return console.log('Could not find USD in the cache.');
}
console.log(`USD's full name is ${usd.name}`);
console.log(`USD uses ${usd.format.scale} decimals`);
});
Exploring
Feel free to check out our documentation to learn about our API and how you can use it.
Notice that the examples above are bits of code separated from each other. You can often use provided properties to get your task done with fewer lines of code by combining the structures explained.
License
This project is licensed under the MIT License.
Disclaimer
The authors of this package are not the authors of tip.cc. We are not responsible for any loss of funds caused by incorrect usage, bugs, exploits, or other causes when using this package.