https://github.com/iamnotstatic/tokenstats
A super simple and lightweight API to get crypto token live information.
https://github.com/iamnotstatic/tokenstats
binance-smart-chain blockchain cryptocurrency ethereum ethereum-contract
Last synced: 11 months ago
JSON representation
A super simple and lightweight API to get crypto token live information.
- Host: GitHub
- URL: https://github.com/iamnotstatic/tokenstats
- Owner: iamnotstatic
- Created: 2021-06-29T16:35:43.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-10-21T19:40:20.000Z (over 4 years ago)
- Last Synced: 2025-03-30T22:32:19.751Z (about 1 year ago)
- Topics: binance-smart-chain, blockchain, cryptocurrency, ethereum, ethereum-contract
- Language: JavaScript
- Homepage: https://tokenstats.herokuapp.com
- Size: 25.4 KB
- Stars: 20
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## TokenStats 🚀🚀
A super simple and lightweight API to get crypto token live information.
[](http://makeapullrequest.com)
## APP URL
```bash
https://tokenstats.herokuapp.com/
```
### Quick Start
To get token live information
```bash
curl https://tokenstats.herokuapp.com/api/token?network=eth&pair=0xfcc3a312a65ffca5d54e61a7d0e6d95e98752345
```
## Response Codes
### Response Codes
```
200: Success
400: Bad request
401: Unauthorized
404: Cannot be found
405: Method not allowed
422: Unprocessable Entity
50X: Server Error
```
### Error Codes Details
```
100: Bad Request
110: Unauthorized
120: User Authenticaion Invalid
130: Parameter Error
140: Item Missing
150: Conflict
160: Server Error
```
### Networks allowed
```
eth - this is use for tokens on Ethereum
bsc - this is use for tokens on Binance Smart Chain
```
## Usage
The API uses the token pair address and network to get stats, you pass the pair and network as a query parameter to the above url
```json
GET /api/token/ HTTP/1.1
Accept: application/json
Content-Type: application/json
params {
"network": "eth",
"pair": "0xfcc3a312a65ffca5d54e61a7d0e6d95e98752345",
}
```
**Successful Response:**
```json
HTTP/1.1 200 Ok
Server: API
Content-Type: application/json
{
"tokenName": "Token Name",
"priceUSD": 0.03259909,
"price": 0.03259909,
"marketCapUSD": 1325990.92,
"tokenToChain": 0.0001113,
"chainToToken": 9199.33598129,
"totalSupply": 20000000,
"totalLiquidityUSD": 25412.3,
"holders": 2930,
"totalTx": 5662
}
```
# Author 💖
[Abdulfatai Suleiman](https://twitter.com/iamnotstatic)!