TokenFOMO API
The API provides endpoints for 1) fetching all tokens created in the last 7 days for the specified network, and 2) fetching liquidity amounts for a given token.
Pricing
The cost is 30 USD per month for unlimited requests. A free trial is available. Contact @TokenFomoApp on Twitter for more information and to obtain access.
Authentication
Requests are authenticated by passing the apikey
query parameter in the URL.
Rate Limit
No more than one request per second is allowed. Multiple requests within one second period will return 503 status.
Supported Chains
Endpoints require the chain to be specified using the network
parameter. Supported values are:
eth , ethereum | Ethereum |
bsc | BNB Smart Chain |
poly , polygon | Polygon |
ftm , fantom | Fantom |
arb , arbitrum | Arbitrum |
kcc | KuCoin Community Chain |
avax , avalanche | Avalanche |
xdai , gnosis | Gnosis |
harmony | Harmony |
kcc | KuCoin Community Chain |
cronos | Cronos |
metis | Metis |
moonriver | Moonriver |
moonbeam | Moonbeam |
heco ,huobieco | Huobi ECO |
smartbch | Smart BCH |
hsc | Hoo Smart Chain |
Endpoints
List Tokens
List all tokens created in the last 7 days for the specified network.
GET https://tokenfomo.io/api/tokens/[network]?apikey=APIKEY
Optional parameters:
limit | Number of tokens to return |
offset | Number of tokens to skip |
Returns a JSON array of token objects.
Example
Request:
curl "https://tokenfomo.io/api/tokens/bsc?limit=10&apikey=APIKEY"
Response:
[
{
"network": "BSC",
"addr": "0xe9a8c835ed2bb04f2247fb24e528372f0f059954",
"name": "RPG",
"symbol": "$RPG",
"timestamp": "1624082856"
},
...
]
Fetch Token Liquidity
Fetch current liquidity for specified token network/address.
GET https://tokenfomo.io/api/tokens/[network]/[address]?apikey=APIKEY
Returns a JSON object including the LP address and liquidity amounts for both tokens in the pair.
Example
Request:
curl "https://tokenfomo.io/api/tokens/bsc/0x707a96d7aeb0030c0de9d77dd1719d2d4855d342?limit=10&apikey=APIKEY"
Response:
{
"lpAddress": "0x84921920ff47a6b2c0ef862f2a4407d568cb0639",
"reserve0Address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
"reserve0Amount": 159.03931633949938,
"reserve1Address": "0x707a96d7aeb0030c0de9d77dd1719d2d4855d342",
"reserve1Amount": 1729926.5752192168
}