ERC20 Tokens

Temporarily available only for the AUSD token on chain IDs: 1, 137, 1433, 13371, 43114, 747474.

Get Token Supply

Return the total supply of one or more ERC20 tokens on a given chain.

curl -X GET \
  "https://api.misti.app/v1/erc20/supply \
    ?chain_id=1 \
    &token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
    &token=0xdAC17F958D2ee523a2206206994597C13D831ec7" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:

Parameter	Type	Required	Description
`chain_id`	`number`	Yes	The EVM chain ID (e.g., `1` for Ethereum mainnet). Table chain id
`token`	`string`	Yes	ERC20 token contract address (`0x…`). Pass multiple `token` params for batch queries (max 20)

Headers:

Header	Description
`x-api-key`	Your API key (`msk_…`)

Response:

[
    {
        "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chain_id": 1,
        "total_supply": "40000000000000000000000"
    },
    {
        "token_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "chain_id": 1,
        "total_supply": "69725286419267994"
    }
]

Get Token Supply History

Return the daily total supply of an ERC20 token over a date range on a given chain.

⚠️

The date range between from and to must not exceed 365 days.

curl -X GET \
  "https://api.misti.app/v1/erc20/supply-history \
    ?chain_id=1 \
    &token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
    &from=2025-01-01 \
    &to=2025-06-30" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:

Parameter	Type	Required	Description
`chain_id`	`number`	Yes	The EVM chain ID (e.g., `1` for Ethereum mainnet). Table chain id
`token`	`string`	Yes	ERC20 token contract address (`0x…`)
`from`	`string`	No	Start date in `YYYY-MM-DD` format
`to`	`string`	No	End date in `YYYY-MM-DD` format

Headers:

Header	Description
`x-api-key`	Your API key (`msk_…`)

Response:

[
    {
        "date": "2025-01-01",
        "total_supply": "40000000000000000000000"
    },
    {
        "date": "2025-01-02",
        "total_supply": "40050000000000000000000"
    }
]

Get Token Balance

Return the current balance of one or more ERC20 tokens for a specific wallet on a given chain.

curl -X GET \
  "https://api.misti.app/v1/erc20/balance \
    ?chain_id=1 \
    &token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
    &token=0xdAC17F958D2ee523a2206206994597C13D831ec7 \
    &wallet=0x37305B1cD40574E4C5Ce33f8e8306Be057fD7341" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:

Parameter	Type	Required	Description
`chain_id`	`number`	Yes	The EVM chain ID (e.g., `1` for Ethereum mainnet). Table chain id
`token`	`string`	Yes	ERC20 token contract address (`0x…`). Pass multiple `token` params for batch queries (max 20)
`wallet`	`string`	Yes	Wallet address to query the balance for (`0x…`)

Headers:

Header	Description
`x-api-key`	Your API key (`msk_…`)

Response:

[
    {
        "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chain_id": 1,
        "wallet_address": "0x37305B1cD40574E4C5Ce33f8e8306Be057fD7341",
        "balance": "2500000000000000000000"
    },
    {
        "token_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "chain_id": 1,
        "wallet_address": "0x37305B1cD40574E4C5Ce33f8e8306Be057fD7341",
        "balance": "1800000000000000000000"
    }
]

Get Token Balance History

Return the daily balance of an ERC20 token for a specific wallet over a date range on a given chain.

⚠️

The date range between from and to must not exceed 365 days.

curl -X GET \
  "https://api.misti.app/v1/erc20/balance-history \
    ?chain_id=1 \
    &token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
    &wallet=0x37305B1cD40574E4C5Ce33f8e8306Be057fD7341 \
    &from=2025-01-01 \
    &to=2025-06-30" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:

Parameter	Type	Required	Description
`chain_id`	`number`	Yes	The EVM chain ID (e.g., `1` for Ethereum mainnet). Table chain id
`token`	`string`	Yes	ERC20 token contract address (`0x…`)
`wallet`	`string`	Yes	Wallet address to query the balance for (`0x…`)
`from`	`string`	No	Start date in `YYYY-MM-DD` format
`to`	`string`	No	End date in `YYYY-MM-DD` format

Headers:

Header	Description
`x-api-key`	Your API key (`msk_…`)

Response:

[
    {
        "date": "2025-01-01",
        "balance": "2500000000000000000000"
    },
    {
        "date": "2025-01-02",
        "balance": "2480000000000000000000"
    }
]

Get Token Holder Count

Return the number of holders for one or more ERC20 tokens on a given chain.

curl -X GET \
  "https://api.misti.app/v1/erc20/holder-count \
    ?chain_id=1 \
    &token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
    &token=0xdAC17F958D2ee523a2206206994597C13D831ec7" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:

Parameter	Type	Required	Description
`chain_id`	`number`	Yes	The EVM chain ID (e.g., `1` for Ethereum mainnet). Table chain id
`token`	`string`	Yes	ERC20 token contract address (`0x…`). Pass multiple `token` params for batch queries (max 20)

Headers:

Header	Description
`x-api-key`	Your API key (`msk_…`)

Response:

[
    {
        "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chain_id": 1,
        "holder_count": 2456789
    },
    {
        "token_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "chain_id": 1,
        "holder_count": 5678123
    }
]

Get Token Holders

Return the list of holders for an ERC20 token on a given chain, sorted by balance.

curl -X GET \
  "https://api.misti.app/v1/erc20/holders \
    ?chain_id=1 \
    &token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
    &first=10 \
    &offset=0 \
    &sort=desc" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:

Parameter	Type	Required	Description
`chain_id`	`number`	Yes	The EVM chain ID (e.g., `1` for Ethereum mainnet). Table chain id
`token`	`string`	Yes	ERC20 token contract address (`0x…`)
`first`	`number`	No	Number of holders to return (1–100, default `50`)
`offset`	`number`	No	Number of holders to skip for pagination (default `0`)
`sort`	`string`	No	Sort order by balance: `asc` or `desc` (default `desc`)

Headers:

Header	Description
`x-api-key`	Your API key (`msk_…`)

Response:

[
    {
        "wallet_address": "0x37305B1cD40574E4C5Ce33f8e8306Be057fD7341",
        "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chain_id": 1,
        "balance": "2500000000000000000000"
    },
    {
        "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
        "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "chain_id": 1,
        "balance": "1800000000000000000000"
    }
]

Gas Pool