[*paid advertisement]

< Back

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, ethereumEthereum
bscBNB Smart Chain
poly, polygonPolygon
ftm, fantomFantom
arb, arbitrumArbitrum
kccKuCoin Community Chain
avax, avalancheAvalanche
xdai, gnosisGnosis
harmonyHarmony
kccKuCoin Community Chain
cronosCronos
metisMetis
moonriverMoonriver
moonbeamMoonbeam
heco,huobiecoHuobi ECO
smartbchSmart BCH
hscHoo 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:

limitNumber of tokens to return
offsetNumber 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
}