ERC20 Tokens
Get Token Information
Return detailed information about an ERC20 token including totalSupply, name, symbol, decimals and other metadata.
https://misti.up.railway.app/api/tokens/info
?chainid=1
&address=0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4
&apikey=YourApiKeyToken
Query Parameters:
Parameter | Description |
---|---|
chainid | The chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id |
address | The ERC20 token contract address |
apikey | Your API key |
Response:
{
"token_address": "0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4",
"chain_id": 1,
"name": "Example Token",
"symbol": "EXT",
"decimals": 18,
"total_supply": "40000000000000000000000",
"total_supply_formatted": "40000.000000",
"holder_count": 15420,
"transfer_count": 234567,
"contract_creator": "0xabcdef123456789abcdef123456789abcdef123456",
"creation_block": 17800000,
"creation_timestamp": "2023-08-15T10:30:45Z",
"logo_url": "https://example.com/token-logo.png",
}
Get Token Holders
Return the current ERC20 token holders and number of tokens held.
https://misti.up.railway.app/api/tokens/holders
?chainid=1
&address=0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4
&limit=100
&offset=0
&apikey=YourApiKeyToken
Query Parameters:
Parameter | Description |
---|---|
chainid | The chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id |
address | The ERC20 token contract address |
limit | Maximum number of holders to return (default: 100, max: 1000) |
offset | Number of records to skip for pagination (default: 0) |
apikey | Your API key |
Response:
The response will be a JSON object containing the token holders information.
{
"token_address": "0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4",
"chain_id": 1,
"total_holders": 15420,
"holders": [
{
"wallet_address": "0x123456789abcdef123456789abcdef123456789a",
"balance": "1000000000000000000000",
"balance_formatted": "1000.000000",
},
{
"wallet_address": "0x987654321fedcba987654321fedcba987654321b",
"balance": "500000000000000000000",
"balance_formatted": "500.000000",
}
]
}
Get Token Balance
Return the token balance for multiple wallet addresses (max 100 wallets per request).
https://misti.up.railway.app/api/tokens/balance
?chainid=1
&address=0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4
&wallets=0x123456789abcdef123456789abcdef123456789a,0x987654321fedcba987654321fedcba987654321b
&apikey=YourApiKeyToken
Query Parameters:
Parameter | Description |
---|---|
chainid | The chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id |
address | The ERC20 token contract address |
wallets | Comma-separated list of wallet addresses (max 100 wallets) |
apikey | Your API key |
Response:
{
"token_address": "0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4",
"chain_id": 1,
"balances": [
{
"wallet_address": "0x123456789abcdef123456789abcdef123456789a",
"balance": "1000000000000000000000",
"balance_formatted": "1000.000000",
},
{
"wallet_address": "0x987654321fedcba987654321fedcba987654321b",
"balance": "500000000000000000000",
"balance_formatted": "500.000000",
}
]
}
Get Token Historical Balances
Return historical balance data for a specific ERC20 token and wallet address over time.
https://misti.up.railway.app/api/tokens/balance/history
?chainid=1
&address=0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4
&wallet=0x123456789abcdef123456789abcdef123456789a
&limit=30
&offset=0
&apikey=YourApiKeyToken
Query Parameters:
Parameter | Description |
---|---|
chainid | The chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id |
address | The ERC20 token contract address |
wallet | The wallet address to get historical balances for |
limit | Maximum number of data points to return (default: 30, max: 1000) |
offset | Number of records to skip for pagination (default: 0) |
apikey | Your API key |
Response:
{
"token_address": "0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4",
"wallet_address": "0x123456789abcdef123456789abcdef123456789a",
"chain_id": 1,
"historical_balances": [
{
"date": "2024-01-15T00:00:00Z",
"balance": "1000000000000000000000",
"balance_formatted": "1000.000000",
"balance_change": "50000000000000000000",
"balance_change_formatted": "+50.000000",
"block_number": 19120370
},
{
"date": "2024-01-14T03:00:00Z",
"balance": "950000000000000000000",
"balance_formatted": "950.000000",
"balance_change": "-25000000000000000000",
"balance_change_formatted": "-25.000000",
"block_number": 19100370
},
{
"date": "2024-01-13T02:00:00Z",
"balance": "975000000000000000000",
"balance_formatted": "975.000000",
"balance_change": "+975000000000000000000",
"balance_change_formatted": "+975.000000",
"block_number": 19080370
}
]
}
Get Token Price
Return the current price information for an ERC20 token.
https://misti.up.railway.app/api/tokens/price
?chainid=1
&address=0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4
&apikey=YourApiKeyToken
Query Parameters:
Parameter | Description |
---|---|
chainid | The chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id |
address | The ERC20 token contract address |
apikey | Your API key |
Response:
{
"token_address": "0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4",
"chain_id": 1,
"symbol": "EXT",
"name": "Example Token",
"current_price": {
"usd": 1.25,
"eth": 0.000427,
"btc": 0.000028
},
"market_data": {
"market_cap_usd": 50000000.0,
"volume_24h_usd": 2500000.75,
"price_change_24h": 5.2,
"price_change_percentage_24h": 4.34,
"price_change_7d": -0.15,
"price_change_percentage_7d": -10.7,
"high_24h": 1.32,
"low_24h": 1.18,
"circulating_supply": 40000000.0,
"total_supply": 40000000.0,
"max_supply": 100000000.0
},
"last_updated": "2024-01-15T14:30:45Z"
}
Get Token Historical Prices
Return historical price data for an ERC20 token with daily or hourly intervals.
https://misti.up.railway.app/api/tokens/price/history
?chainid=1
&address=0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4
&period=d
&limit=30
&offset=0
&apikey=YourApiKeyToken
Query Parameters:
Parameter | Description |
---|---|
chainid | The chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id |
address | The ERC20 token contract address |
period | Tracking period: d for daily data, h for hourly data |
limit | Maximum number of data points to return (default: 30, max: 1000) |
offset | Number of records to skip for pagination (default: 0) |
apikey | Your API key |
Response:
{
"token_address": "0xa0b86a33e6441e7c5a3b5f2b5c26e8b8a1b2a3d4",
"chain_id": 1,
"symbol": "EXT",
"name": "Example Token",
"period": "d",
"historical_prices": [
{
"date": "2024-01-15T00:00:00Z",
"price_usd": 1.25,
"price_eth": 0.000427,
"price_btc": 0.000028,
"volume_24h": 2500000.75,
"market_cap": 50000000.0,
"open": 1.20,
"high": 1.32,
"low": 1.18,
"close": 1.25,
"price_change_24h": 5.2,
"price_change_percentage_24h": 4.34
},
{
"date": "2024-01-14T00:00:00Z",
"price_usd": 1.20,
"price_eth": 0.000410,
"price_btc": 0.000027,
"volume_24h": 1800000.50,
"market_cap": 48000000.0,
"open": 1.15,
"high": 1.25,
"low": 1.12,
"close": 1.20,
"price_change_24h": 0.05,
"price_change_percentage_24h": 4.35
}
]
}