Lynx API
Search
K
Comment on page
🔍

Token Search

Endpoint

GET /v1/tokens/search?searchString=<SEARCH_STRING>&chains=<CHAIN_IDS>

Description

This endpoint searches for tokens that match the given search criteria. The searchString parameter is required and should be a string that is used to match against token names, contracts, or symbols. The chains parameter is optional and should be a comma-separated list of chain Ids that limits the search results to tokens that exist on the specified chains.

Note

This endpoint is limited to returning a maximum of 15 search results.

Query String Parameters

  • searchString (required): A string that is used to match against token names, contracts, or symbols.
  • chains (optional): A comma-separated list of chain Ids that limits the search results to tokens that exist on the specified chains.

Headers

  • x-api-key (required): A valid API key.

Example

curl -X GET 'https://api.lynxcrypto.app/v1/tokens/search?searchString=inu&chains=1,56'

Response

[
{
"contract": "0x7db5af2b9624e1b3b4bb69d6debd9ad1016a58ac",
"chain": "56",
"name": "volt inu",
"symbol": "volt",
"usd_price": 9.433851652040907e-10,
"price_change": -99.9440356105966,
"decimals": 9,
"total_supply": 69000000000000,
"project_info": {
"website": "https://voltinu.in/",
"logo_url": "https://token-images.s3.amazonaws.com/voltlogo.png",
"twitter": "https://twitter.com/VoltInuOfficial",
"discord": null
}
},
{
"contract": "0x2859e4544c4bb03966803b044a93563bd2d0dd4d",
"chain": "56",
"name": "shiba inu",
"symbol": "shib",
"usd_price": 0.00001305552632945143,
"price_change": -1.1793354676905874,
"decimals": 18,
"total_supply": 7249999999990.642,
"project_info": {
"website": null,
"logo_url": null,
"twitter": null,
"discord": null
}
}
]

Response Codes

  • 200: Success. Returns the tokens that match the search criteria.
  • 400: Bad Request. The searchString query string parameter is not provided.
  • 403: Forbidden. The x-api-key header is not provided or is invalid.
  • 404: Not Found. No tokens were found with the given search criteria.