• SQL: Allium Developer runs on ClickHouse for Solana and Postgres for all other chains.
  • Timestamps: All timestamps are in Coordinated Universal Time (UTC).
  • Prices: All prices-related data are in USD denomination unless otherwise stated.
  • Address Casing: All EVM addresses are in lower casing.
  • Native token: Native tokens are represented by the zero address for most chains. For example,
    • for Ethereum and most EVM chains: 0x0000000000000000000000000000000000000000
    • for Tron: T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb

Token Liquidity

In some of our endpoints, you can pass with_liquidity_info=true to the query parameters to get liquidity info. This can be useful to filter out spam/scam tokens from your application. This data will be available in the total_liquidity_usd field. For example, you can use this to filter for tokens with at least $5000 USD (adjust according to your preferences):
balances = requests.post(
    "https://api.allium.so/api/v1/developer/wallet/balances",
    query={"with_liquidity_info": True},
    # API key, etc
    ...
).json()["items"]

balances_with_high_liquidity = []
for balance in balances:
    liquidity = balance["token"].get("attributes", {}).get("total_liquidity_usd")
    # See below for possible return values
    if liquidity is not None and (liquidity == "TOO_MANY_POOLS" or liquidity >= 5000):
        balances_with_high_liquidity.append(balance)

# Do anything with balances_with_high_liquidity...
Here are the possible return values:
  • float, indicating the sum of USD value of the total liquidity of the token across all pools.
  • the string constant TOO_MANY_POOLS, indicating that there are too many pools for the token. This indicates that the token is very popular, and hence very likely not a scam, for example WETH in Ethereum chain.
  • null, indicating no liquidity information exists for the pool.
Our methodology is:
  • from a token, get all pools associated with it
  • if there are too many pools (currently more than 10000 pools), return TOO_MANY_POOLS
  • get the total amount of tokens inside all those pools
  • multiply them with the price of that token to get total_liquidity_usd