Assets

What is this endpoint for?

This endpoint receives information on the trades involving a particular asset. Information includes volumes, trade counts, liquidity, and supply. All information is broken down by exchange. Trade data is aggregated across all instruments that include the specified token as a base or quote asset, whereas liquidity data is aggregated for the base asset only.

Endpoint

https://us.market-api.kaiko.io/v2/data/analytics.v2/asset_metrics

Parameters

Parameter	Required	Description	Example
asset	Yes	The desired asset code. See Instruments	agix
start_time	Yes	Starting time in ISO 8601 (inclusive).	2023-01-25T00:00:00.000Z
end_time	Yes	Ending time in ISO 8601 (exclusive).	2023-01-26T00:00:00.000Z
interval	Yes	The interval parameter is suffixed with h or d to specify hours or days, respectively. Any arbitrary value between one second and one day can be used, as long as it sums up to a maximum of 1 day. The suffixes are h (hour) and d (day). Default: 1h.	1h
sources	No	boolean. If true, returns trading information and market depths detailed by exchanges as well as main holders. Default: false
page_size	No	See Pagination Minimum: 1 Maximum: 100 Default: 10	100

Fields

For any field in the "token information" category, we only cover ERC-20 tokens. Only 50 tokens have been backfilled, but we can add more on demand.

Field	Category	Description	Example
timestamp	Trading activity	Timestamp at which the interval begins.	2023-01-25T00:00:00.000Z
price	Trading activity	Average price in usd. null when no trades are reported.	0.1699233217119519
total_volume_usd	Trading activity	Total volume in usd traded in the interval. 0 when no trades are reported.	30508181.43789653
total_volume_asset	Trading activity	Total volume in number of assets traded in the interval. 0 when no trades are reported.	179540872.49784896
total_trade_count	Trading activity	The total amount of trades reported during the interval. 0 when no trades are reported.	159684
total_off_chain_volume_usd	Trading activity	Total off-chain volume in usd traded in the interval. 0 when no trades are reported.	30038710.382665947
total_off_chain_volume_asset	Trading activity	Total off-chain volume in number of assets traded in the interval. 0 when no trades are reported.	176778031.87949985
total_off_chain_trade_count	Trading activity	The total amount of trades reported off-chain during the interval. 0 when no trades are reported.	159115
trades_data	Trading activity	List of volume in usd, volume in number of assets and total amount of trades by centralized exchange.	[{"exchange": "binc", "volume_usd": 27539301.29722444, "volume_asset": 162068991, "trade_count": 125188}, ...]
total_on_chain_volume_usd	Trading activity	Total on-chain volume in usd traded in the interval. 0 when no trades are reported.	1036710779.1918713
total_on_chain_volume_asset	Trading activity	Total on-chain volume in number of assets traded in the interval. 0 when no trades are reported.	1036710779.1918713
total_on_chain_trade_count	Trading activity	The total amount of trades reported on-chain during the interval. 0 when no trades are reported.	20513
trades_data	Trading activity	List of volume in usd, volume in number of assets and total amount of trades by decentralized exchange.	[{'exchange': 'blc2', 'volume_usd': 673716.6525764248, 'volume_asset': 674153.2032810001, 'trade_count': 129}, ...]
market_depth	Liquidity information	Dictionary from 0.1% to 10% market depth. Base asset aggregation only.
blockchain	Token information	Blockchain name.	ethereum
token_address	Token information	Token address.	0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
number_of_holders	Token information	Total amount of holders.	1622286
main_holders	Token information	List of addesses holding at least 1% of the total supply and the amounts of tokens.	[{'address': '0x0a59649758aa4d66e25f08dd01271e891fe52199', 'amount': 3262712000, 'percentage': 7.91745}, ...]
total_supply	Token information	Blockchain total supply.	0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

Request example

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: <client-api-key>' \
'https://us.market-api.kaiko.io/v2/data/analytics.v2/asset_metrics?interval=1d&asset=agix&start_time=2023-01-25T00:00:00.000Z&end_time=2023-01-26T00:00:00.000Z&page_size=100&sources=true'

Response example

JSON

{
    "data": [
        {
            "timestamp": "2023-01-25T00:00:00.000Z",
            "price": 0.1699233217119519,
            "total_volume_usd": 30508181.43789653,
            "total_volume_asset": 179540872.49784896,
            "total_trade_count": 159684,
            "off_chain_liquidity_data": {
                "total_off_chain_volume_usd": 30038710.382665947,
                "total_off_chain_volume_asset": 176778031.87949985,
                "total_off_chain_trade_count": 159115,
                "trade_data": [
                    {
                        "exchange": "binc",
                        "volume_usd": 27539301.29722444,
                        "volume_asset": 162068991,
                        "trade_count": 125188
                    },
                    /* ... */
                ],
                "buy_market_depths": [
                    {
                        "exchange": "binc",
                        "volume_assets": {
                            /* ... */
                        },
                        "volume_usds": {
                            /* ... */
                        }
                    }, 
                    /* ... */
                ],
                "sell_market_depths": [
                    {
                        "exchange": "binc",
                        "volume_assets": {
                           /* ... */
                        },
                        "volume_usds": {
                           /* ... */
                        }
                    }, 
                    /* ... */
                ],
                "total_buy_market_depth": {
                    "volume_assets": {
                       /* ... */
                    },
                    "volume_usds": {
                       /* ... */
                    }
                },
                "total_sell_market_depth": {
                    "volume_assets": {
                       /* ... */
                    },
                    "volume_usds": {
                       /* ... */
                    }
                }
            },
            "on_chain_liquidity_data": {
                "total_on_chain_volume_usd": 2762840.6183491,
                "total_on_chain_volume_asset": 2762840.6183491,
                "total_on_chain_trade_count": 569,
                "trades_data": [
                    {
                        "exchange": "usp2",
                        "volume_usd": 327680.4492221988,
                        "volume_asset": 1928401.8575017697,
                        "trade_count": 448
                    },
                    /* ... */
                ],
                "token_information": [
                    {
                        "blockchain": "ethereum",
                        "token_address": "0x5B7533812759B45C2B44C19e320ba2cD2681b542",
                        "nb_of_holders": 38231,
                        "main_holders": [
                            {
                                "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
                                "amount": 250774980,
                                "percentage": 22.61839
                            },
                            {
                                "address": "0x13e1367a455c45aa736d7ff2c5656ba2bd05ad46",
                                "amount": 112149660,
                                "percentage": 10.11522
                            }, 
                            /* ... */
                        ],
                        "total_supply": 1108721700
                    }
                ]
            }
        }
    ]
}