Token Search

Search for real-time or historical token information and logos.

The endpoint is in alpha. We do not recommend use for production.

Get Tokens Logos

GET https://api.abyiss.com/v1/dex/{exchange}/{blockchain}/tokens

Returns an array of real-time or historical token data on a decentralized exchange.

Path Parameters

Name	Type	Description
exchange*	string	Decentralized exchange Id
blockchain*	string	Blockchain for decentralized exchange

Query Parameters

Name	Type	Description
apiKey*	string	Your Abyiss API Key
limit	int	Number of results per request. Maximum 1,0000 (defualt 100)
orderBy	string	Sort the returned data by any field in the API response, such as id, name, symbol, volumeUSD and more.
orderDirection	string	asc or desc return the results sorted by that field in either ascending or descending order.
skip	int	Number of results to skip per request.
tokenSymbol	string	Filters the results to show only records with the specified token symbol. Example: WETH
tokenId	string	Filters the results to show only records with the specified token ID. Example: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
tokeName	string	Filters the results to show only records with the specified token name. Example: Wrapped Ethereum
logo	boolean	Determines whether or not to include the logo in the response. Example: true or false

200: OK Success

[
    {
        "id": "0x00000000000045166c45af0fc6e4cf31d9e14b9a",
        "name": "TopBidder",
        "symbol": "BID",
        "decimals": "18",
        "supply": "28240",
        "totalValueLocked": "45.690660599764812617",
        "totalValueLockedUSD": "0",
        "volume": "8347.641875381858852443",
        "volumeUSD": "8114.480070327402387046118602321907",
        "untrackedVolumeUSD": "4057.240035163701193523059301160956",
        "txCount": "15",
        "derivedETH": "0",
        "feesUSD": "81.14480070327402387046118602321907",
        "totalValueLockedUSDUntracked": "0",
        "poolCount": "0"
    }
]

401: Unauthorized Unauthorized -- Invalid API Key

{
    "Unauthorized": "Invaild API Key"
}

Copy & Paste Code

Curl

curl -H "apiKey: API KEY" https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens

Python

import urllib.request
url = "https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?apiKey=*"
print(urllib.request.urlopen(url).read())

JavaScript

fetch("https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?apiKey=*")
  .then(response => response.json())
  .then(data => console.log(data))

Node.js

require('axios')
  .get("https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?apiKey=*")
  .then(response => console.log(response))

Ruby

require 'net/http'
uri = URI("https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?apiKey=*")
puts Net::HTTP.get(uri)

Example URLs:

• https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?apiKey=

• https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?tokenSymbol=WETH&logo=true&apiKey=

• https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?tokenId=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&logo=true&apiKey=

• https://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?tokenName=Ethereum&logo=true&apiKey=

• http://api.abyiss.com/v1/dex/uniswap/ethereum/tokens?tokenSymbol=WETH&tokenId=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&logo=true&tokenName=EthereumNameService&apiKey=

Response Object

[
    {
        "id": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "name": "SHIBA INU",
        "symbol": "SHIB",
        "decimals": "18",
        "supply": "18240",
        "totalValueLocked": "1006152663747.818392476644062536",
        "totalValueLockedUSD": "9989860.304795510277702975232615195",
        "volume": "266698446900978.998654557602976886",
        "volumeUSD": "3901300011.472526871991542874821034",
        "untrackedVolumeUSD": "3942142264.394503491291958788380872",
        "txCount": "629286",
        "derivedETH": "0.000000005224360344368931294971240286955516",
        "feesUSD": "23415626.21105531686238648984594351",
        "totalValueLockedUSDUntracked": "0",
        "poolCount": "0",
        "logo": "https://raw.githubusercontent.com/abyiss/assets/master/blockchains/ethereum/assets/0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE/logo.png"
    }
]

Response Attributes

Attribute Name	Data Type	Description
id	string	Token contact address
name	string	Token name
symbol	string	Token symbol
tokenDecimals	string	Token decimals
totalSupply	string	Token total supply
tokenTotalValueLocked	string	Liquidity across all pools in token units
tokenTotalValueLockedUSD	string	Liquidity across all pools in derived USD
tokenVolume	string	Volume in token units
tokenVolumeUSD	string	Volume in derived USD
tokenUntrackedVolumeUSD	string	Volume in USD even on pools with less reliable USD values
tokenTxCount	string	Transactions across all pools that include this token
tokenDerivedETH	string	Derived price in ETH
tokenFeesUSD	string	Fees in USD
totalValueLockedUSDUntracked	string	TVL derived in USD untracked
poolCount	string	Number of pools containing this token
logo	string	Token Logo URL