Read one token
curl --request GET \
--url https://api.fomoscan.sh/v3/tokens/{network}/{address} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/tokens/{network}/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v3/tokens/{network}/{address}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"kind": "token",
"id": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"canonical": {
"network": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"symbol": "BONK",
"name": "Bonk",
"decimals": 5,
"imageUrl": "https://img.example.com/a/4c2e8a1f7b3d9e6a0f5c1b8d2e7a4f3c.webp",
"firstSeenAt": "2025-01-09T00:12:40.000Z",
"market": {
"price": {
"value": "18741200000000",
"decimals": 18,
"currency": "USD"
},
"marketCap": {
"value": "1544807000000000",
"decimals": 6,
"currency": "USD"
},
"fdv": {
"value": "1663510000000000",
"decimals": 6,
"currency": "USD"
},
"liquidity": {
"value": "38102440000000",
"decimals": 6,
"currency": "USD"
},
"volume24h": {
"value": "241905300000000",
"decimals": 6,
"currency": "USD"
},
"holders": 991027,
"priceChange24h": -4.76310482,
"observedAt": "2026-11-01T08:55:00.000Z"
}
},
"sources": {
"fomo": {
"market": {
"price": {
"value": "18734000000000",
"decimals": 18,
"currency": "USD"
},
"marketCap": {
"value": "1544210000000000",
"decimals": 6,
"currency": "USD"
},
"fdv": null,
"liquidity": {
"value": "21480320000000",
"decimals": 6,
"currency": "USD"
},
"volume24h": {
"value": "187340100000000",
"decimals": 6,
"currency": "USD"
},
"holders": 982114,
"priceChange24h": -4.81726533,
"observedAt": "2026-11-01T08:55:00.000Z"
}
}
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Tokens
Read one token
One token: network, address, symbol, name, decimals and our copy of its image, with a market block per platform that shows the token and the market across trading venues in canonical.market.
market.priceis USD per whole token with 18 decimals; the other market values are USD with 6.holdersis a count of wallets,priceChange24ha change in percent.- Each
marketblock is the newest reading we hold from that platform, as of itsobservedAt. A field the platform never fills (unfilledinGET /v3/capabilities) is alwaysnull. - When no platform shows the token, we read its market from our market data provider during the call, at most once every 5 minutes per token, on Solana, Ethereum, Base, BNB Chain, Robinhood and Arc. A token we had not seen before is answered from that read. The price of the call does not change.
- Trades (
GET /v3/trades) carry token quantities only. Read prices here.
Price
The price depends on the answer.
| Answer | Credits | Reveals |
|---|---|---|
| We hold the token, or our market data provider read it within the wait. | 100 | 0 |
| 404: we never saw the token, and the provider did not know it within the wait. | 100 | 0 |
Limits
- 2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.
- A key with less than 100 credits left gets 402
QUOTA_EXCEEDEDbefore any work. - When no platform shows the token, a read of our market data provider runs up to 2 seconds inside the call. Past that the call answers with what we hold, and the read finishes for your next call.
GET
/
v3
/
tokens
/
{network}
/
{address}
Read one token
curl --request GET \
--url https://api.fomoscan.sh/v3/tokens/{network}/{address} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/tokens/{network}/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fomoscan.sh/v3/tokens/{network}/{address}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"kind": "token",
"id": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"canonical": {
"network": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"symbol": "BONK",
"name": "Bonk",
"decimals": 5,
"imageUrl": "https://img.example.com/a/4c2e8a1f7b3d9e6a0f5c1b8d2e7a4f3c.webp",
"firstSeenAt": "2025-01-09T00:12:40.000Z",
"market": {
"price": {
"value": "18741200000000",
"decimals": 18,
"currency": "USD"
},
"marketCap": {
"value": "1544807000000000",
"decimals": 6,
"currency": "USD"
},
"fdv": {
"value": "1663510000000000",
"decimals": 6,
"currency": "USD"
},
"liquidity": {
"value": "38102440000000",
"decimals": 6,
"currency": "USD"
},
"volume24h": {
"value": "241905300000000",
"decimals": 6,
"currency": "USD"
},
"holders": 991027,
"priceChange24h": -4.76310482,
"observedAt": "2026-11-01T08:55:00.000Z"
}
},
"sources": {
"fomo": {
"market": {
"price": {
"value": "18734000000000",
"decimals": 18,
"currency": "USD"
},
"marketCap": {
"value": "1544210000000000",
"decimals": 6,
"currency": "USD"
},
"fdv": null,
"liquidity": {
"value": "21480320000000",
"decimals": 6,
"currency": "USD"
},
"volume24h": {
"value": "187340100000000",
"decimals": 6,
"currency": "USD"
},
"holders": 982114,
"priceChange24h": -4.81726533,
"observedAt": "2026-11-01T08:55:00.000Z"
}
}
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Authorizations
bearerAuthapiKeyHeader
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The network the token lives on.
Available options:
solana, ethereum, base, bsc, arbitrum, optimism, polygon, robinhood, hyperevm, monad, arc, xlayer, ink, hyperliquid The token address on that network: the mint on Solana.
Required string length:
1 - 128Response
OK
A token on one network.
The kind of object, token here, and the only field to switch on. Skip objects whose kind you do not know.
Allowed value:
"token"Our id of the object, tok_<network>_<address>. Store it: it stays the same across calls and never holds a platform's own id.
Fields that mean the same on every platform.
Show child attributes
Show child attributes
Capability blocks keyed by platform. A platform key is absent when the object has no side on that platform. A block is absent when the platform cannot provide it (GET /v3/capabilities lists which can) or we hold no reading of it yet. A field is null when the platform left it empty at observedAt or never fills it (unfilled in GET /v3/capabilities). Skip platform keys and blocks you do not know.
Show child attributes
Show child attributes