Token Technicals API
Comprehensive technical analysis service that provides detailed metrics and indicators for tokens.
Endpoint
GET /api/token-technicals?address=:tokenAddressParameters
| Parameter | Required | Description |
|---|---|---|
| address | Yes | The token address to fetch technicals for |
Headers
| Header | Description |
|---|---|
| x-api-key | Your API key for authentication |
Response Structure
Main Response Object
-
statusCode: HTTP status code -
message: Optional message string -
data: Main data object containing technical analysis
overtimeTechnicals
Historical technical data points, with the most recent first. Each point includes:
id: Unique identifiercontractAddress: Token contract addresschainId: Blockchain network IDsyncedAt: Last sync timestamp (ISO date)holdersCount: Total number of holderstagsCount: Count of different wallet typestopHoldersSupply: Supply held by top holderstopHoldersSupplyPerc: Percentage held by top holders
tokenStats
Detailed token statistics including:
devDeployedTokens: Other tokens by same developerisDevRug: Developer rug pull historyisDevNew: New developer statusdevSoldSupply: Developer's sold tokensdevSoldSupplyPerc: Percentage sold by developerinitialTotalBoughtSupply: Initial buyers' totalpriceNative: Token price in native currencyliquidityNative: Liquidity in native currency
devMakerData
Developer transaction history including:
totalBoughtAmount: Total tokens boughttotalSoldAmount: Total tokens soldtotalBoughtETH: Total ETH spenttotalSoldETH: Total ETH receivedtotalSoldUSD: Total USD value of sellstotalBuyTransactions: Number of buystotalSellTransactions: Number of sells
initialBuyerStats
Analysis of initial token buyers including:
walletAddress: Buyer's addressinitialBuyerType: HOLD/SELL_ALL/SELL_PARTIALsniper: Sniper statusbuyAmount: Amount of tokens purchasedsellAmount: Amount of tokens sold (if any)
Usage Examples
1 Using Node.js with fetch:
import fetch from 'node-fetch';
const TOKEN_ADDRESS = 'TOKEN_ADDRESS';
const API_KEY = 'YOUR_API_KEY';
fetch(`https://api.solapi.live/api/token-technicals?address=${TOKEN_ADDRESS}`, {
headers: {
'x-api-key': API_KEY
}
})
.then(response => response.json())
.then(data => {
const latest = data.data.overtimeTechnicals[0];
const tokenStats = data.data.tokenStats[0];
console.log('Token Technicals Summary:');
console.log('========================');
console.log('\nBasic Info:');
console.log(`Contract Address: ${latest.contractAddress}`);
console.log(`Holders Count: ${latest.holdersCount}`);
console.log('\nTop Holders Distribution:');
Object.entries(latest.topHoldersSupply).forEach(([holders, supply]) => {
const percentage = latest.topHoldersSupplyPerc[holders];
console.log(`Top ${holders} Holders: ${supply} (${percentage}%)`);
});
console.log('\nDeveloper Activity:');
console.log(`Deployed Tokens: ${tokenStats.devDeployedTokensCount}`);
console.log(`Is Dev New: ${tokenStats.isDevNew}`);
console.log(`Is Dev Rug: ${tokenStats.isDevRug}`);
})
.catch(error => console.error('Error:', error));2 Using curl:
curl "https://api.solapi.live/api/token-technicals?address=TOKEN_ADDRESS" \
-H "x-api-key: YOUR_API_KEY"Error Handling
| Status Code | Description |
|---|---|
| 400 | Invalid token address format |
| 404 | Token not found |
| 500 | Internal server error |
Common errors:
- Missing token address
- Invalid token address format
- Server error
Rate Limiting
- 100 requests per minute per API key
- Rate limit headers are included in the response
Notes
- All balance values are returned in the token's smallest unit
- Percentile calculations are based on non-zero balances only
- Contract wallet detection is based on bytecode analysis
- Supply calculations may vary based on token implementation
- Historical data is available through the overtimeTechnicals array
- Developer analysis includes both current and past token deployments