HyperHolders
API Documentation
The HyperHolder API provides data and analytics for tokens on HyperEVM. Use these endpoints to integrate with our services and access token data.
Authentication
All API requests require an API key passed via the X-API-Key header.
API Access Levels
| Level | Name | Requests/second | Daily Limit | Historical Data | Description |
|---|---|---|---|---|---|
| 1 | Basic | 2 | 1000 calls | 7 days | Basic access |
| 2 | Professional | 5 | 10000 calls | 30 days | Extended data access |
| 3 | Enterprise | Custom | Unlimited calls | Custom | Advanced analytics access |
Response Format
Success Response
{
"success": true,
"data": {...} // Response data varies by endpoint
}Some endpoints may include additional metadata:
{
"success": true,
"count": 10, // Number of items returned
"data": [...] // Array of items
}Error Response
{
"success": false,
"error": "Error message"
}Validation errors:
{
"success": false,
"errors": [
{
"msg": "Error description",
"param": "field_name",
"location": "query"
}
]
}Contents
Basic EndpointsBasic
GET /token/infoBasic
Gets detailed information about a specific token.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Contract address of the token |
Response
{
"success": true,
"data": {
"address": "0x...",
"pair_address": "0x...",
"name": "Token Name",
"image_url": "https://...",
"header_url": "https://...",
"socials": {...},
"checkmark": "verified",
"symbol": "TKN",
"created_at": "timestamp"
}
}GET /token/liquidityBasic
Gets liquidity information for specified tokens.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| pairs | string | Yes | Comma-separated list of pair addresses |
| addresses | string | Yes | Comma-separated list of token addresses |
| symbol | string | Yes | Comma-separated list of token symbols |
Response
{
"success": true,
"data": {
"0xPairAddress1": {
"hypeReserve": 1000,
"tokenReserve": 5000,
"tokenPriceHype": 0.2,
"tokenPriceUsd": 0.02,
"liquidityUsd": 200000,
"marketCapHype": 100000,
"marketCapUsd": 10000,
"decimals": "6",
"totalSupply": "1000000000000"
}
}
}GET /token/latestBasic
Gets the most recently added tokens.
Parameters
No parameters required
Response
{
"success": true,
"count": 4,
"data": [
{
"address": "0x...",
"pair_address": "0x...",
"name": "Token Name",
"symbol": "TKN",
"image_url": "https://...",
"holders": [...],
"socials": {...},
"checkmark": "verified",
"liquidity": {...}
}
]
}GET /token/dex-paidBasic
Gets DEX payment information for a token.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Contract address of the token |
Response
{
"success": true,
"data": {...} // Payment data
}GET /chainBasic
Gets global statistics about the blockchain including HYPE price and gas prices.
Parameters
No parameters required
Response
{
"success": true,
"data": {
"price": 0.1,
"gas_prices": {
"average": "1000000",
"fast": "1500000",
"slow": "500000"
}
}
}Professional EndpointsProfessional
GET /tokenProfessional
Retrieves a list of all tracked tokens.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| checkmark | string | No | Filter by verification status ('all', 'verified', etc.) |
Response
{
"success": true,
"count": 42,
"data": [
{
"address": "0x...",
"pair_address": "0x...",
"name": "Token Name",
"image_url": "https://...",
"header_url": "https://...",
"socials": {...},
"checkmark": "verified",
"created_at": "timestamp"
}
]
}GET /token/trendsProfessional
Retrieves trend data for tokens across different time periods.
Parameters
No parameters required
Response
{
"success": true,
"data": {
"4h": {
"gainers": [{...}],
"losers": [{...}]
},
"12h": {...},
"1d": {...},
"3d": {...},
"7d": {...}
}
}GET /token/holdersProfessional
Gets a list of token holders for a specific token.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Contract address of the token |
| count | number | No | Maximum number of holders to return (default: all) |
Response
{
"success": true,
"count": 100,
"data": [
{
"address": "0x...",
"is_contract": false,
"is_scam": false,
"is_verified": true,
"name": "Holder Name",
"value": "1000000"
}
]
}GET /token/analyzeProfessional
Gets holder distribution analysis for a specific token.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Contract address of the token |
Response
{
"success": true,
"data": {
"holderDistribution": [...],
"holderCounts": [...],
"holderCategories": [...],
"marketCapStatistics": [...]
}
}Enterprise EndpointsEnterprise
GET /token/time-analyzeEnterprise
Gets time-based analysis data for token holders.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Contract address of the token |
Response
{
"success": true,
"data": [
{
"key": "top10",
"average": 1623456789,
"displayText": "5 days",
"name": "Top 10 holders"
}
]
}GET /token/time-heldEnterprise
Returns raw holders_time data for a token.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Contract address of the token |
Response
{
"success": true,
"count": 123,
"data": [
{
"address": "0x...",
"initial": "1623456789",
"average": "1623456789"
}
]
}Error Codes
| Status Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters or validation failed |
| 401 | Unauthorized - Missing API key |
| 403 | Forbidden - Invalid API key or insufficient access level |
| 404 | Not Found - Requested resource not found |
| 429 | Too Many Requests - Rate limit or daily limit exceeded |
| 500 | Internal Server Error |
Rate Limiting
Rate limits depend on your API key's access level. When exceeded, the API returns a 429 error with the message "Rate limit exceeded for this API key". Daily limits are also enforced and return a similar 429 error with "Daily API call limit exceeded, please try again tomorrow".