Skip to main content
GET
/
api
/
v1
/
developer
/
tokens
/
search
Search Tokens
curl --request GET \
  --url https://api.allium.so/api/v1/developer/tokens/search \
  --header 'X-API-KEY: <api-key>'
[
  {
    "object": "token",
    "chain": "<string>",
    "address": "<string>",
    "price": 123,
    "decimals": 123,
    "info": {
      "name": "<string>",
      "symbol": "<string>"
    },
    "attributes": {
      "total_supply": 123,
      "fully_diluted_valuation_usd": 123,
      "volume_usd_1h": 123,
      "volume_usd_1d": 123
    }
  }
]
This endpoint returns tokens that match a keyword.
This is a beta endpoint currently under active development. We’re working to stabilize the API and will minimize breaking changes wherever possible, but they may still occur as we refine the interface.For production support or migration assistance, reach out at hello@allium.so.

​
Supported Chains

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
q
string
required

The query string to search in name and symbol. Performs a case-insensitive substring search.

​
chain
string

The chain of the tokens. Do not pass anything to search across all tokens.

​
sort
enum<string>
default:volume

Sort by a certain field

Available options:
volume,
trade_count,
fully_diluted_valuation,
address,
name
​
granularity
enum<string> | null

Granularity of the sorting field. Only used if sort is volume or trade_count.

Available options:
1d,
1h
​
order
enum<string>
default:desc

Sorting order

Available options:
asc,
desc
​
limit
integer
default:200

Maximum number of tokens to return.

Required range: 0 <= x <= 200

Response

Successful Response

​
chain
string
required
​
address
string
required
​
object
string
default:token
Allowed value: "token"
​
price
number | null
​
decimals
integer | null
​
info
object | null
​
attributes
object | null