Skip to content
Documentation
Tokens

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:
ParameterDescription
chainidThe chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id
addressThe ERC20 token contract address
apikeyYour 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:
ParameterDescription
chainidThe chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id
addressThe ERC20 token contract address
limitMaximum number of holders to return (default: 100, max: 1000)
offsetNumber of records to skip for pagination (default: 0)
apikeyYour 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:
ParameterDescription
chainidThe chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id
addressThe ERC20 token contract address
walletsComma-separated list of wallet addresses (max 100 wallets)
apikeyYour 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:
ParameterDescription
chainidThe chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id
addressThe ERC20 token contract address
walletThe wallet address to get historical balances for
limitMaximum number of data points to return (default: 30, max: 1000)
offsetNumber of records to skip for pagination (default: 0)
apikeyYour 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:
ParameterDescription
chainidThe chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id
addressThe ERC20 token contract address
apikeyYour 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:
ParameterDescription
chainidThe chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id
addressThe ERC20 token contract address
periodTracking period: d for daily data, h for hourly data
limitMaximum number of data points to return (default: 30, max: 1000)
offsetNumber of records to skip for pagination (default: 0)
apikeyYour 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
        }
    ]
}