Search assets
curl --request GET \
--url https://flash.definitive.fi/v1/search \
--header 'x-definitive-api-key: <api-key>'import requests
url = "https://flash.definitive.fi/v1/search"
headers = {"x-definitive-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-definitive-api-key': '<api-key>'}};
fetch('https://flash.definitive.fi/v1/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"assets": [
{
"chain": "ethereum",
"address": "0x4200000000000000000000000000000000000006",
"symbol": "<string>",
"name": "<string>",
"decimals": 123,
"price": "<string>",
"marketCap": "<string>",
"liquidity": "<string>",
"volume24h": "<string>",
"priceChange24h": "-0.0342",
"holders": 11,
"imageUrl": "<string>",
"riskFlagged": true
}
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}Utilities REST
Search assets
Search tradable assets by symbol, name, or contract address.
Results are ranked by relevance and market quality, most relevant first. The returned address and chain feed directly into POST /quote as targetAsset/contraAsset and targetChain/contraChain.
Pass chain to restrict results to a single chain.
GET
/
search
Search assets
curl --request GET \
--url https://flash.definitive.fi/v1/search \
--header 'x-definitive-api-key: <api-key>'import requests
url = "https://flash.definitive.fi/v1/search"
headers = {"x-definitive-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-definitive-api-key': '<api-key>'}};
fetch('https://flash.definitive.fi/v1/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"assets": [
{
"chain": "ethereum",
"address": "0x4200000000000000000000000000000000000006",
"symbol": "<string>",
"name": "<string>",
"decimals": 123,
"price": "<string>",
"marketCap": "<string>",
"liquidity": "<string>",
"volume24h": "<string>",
"priceChange24h": "-0.0342",
"holders": 11,
"imageUrl": "<string>",
"riskFlagged": true
}
]
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": null
}
}Authorizations
Your Definitive API key.
Query Parameters
Symbol, name, or contract address.
Minimum string length:
1Example:
"pepe"
Restrict results to a single chain.
Available options:
arbitrum, avalanche, base, bsc, ethereum, optimism, polygon, solana, hyperevm, plasma, monad, robinhood, ink, arc Maximum assets to return. Defaults to 10; capped at 25.
Required range:
1 <= x <= 25Response
Assets returned successfully
Show child attributes
Show child attributes