Stablecoins

What is this endpoint for?

This endpoint receives information on the trades involving a particular stablecoin. Information includes volumes, trade counts, liquidity, supply and lending rates. Trade and liquidity data are aggregated across all instruments that include the specified token as a base or quote asset.

Endpoint

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

Parameters

Parameter

Required

Description

Example

asset

Yes

The desired stablecoin asset code. See Asset codes

usdc

start_time

Starting time in ISO 8601 (inclusive).

2023-01-25T00:00:00.000Z

end_time

Ending time in ISO 8601 (exclusive).

2023-01-26T00:00:00.000Z

page_size

See Pagination Minimum: 1 Maximum: 100

Default: 10

100

Fields

Field

Request examples

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: <client-api-key>' \
'https://us.market-api.kaiko.io/v2/data/analytics.v2/stablecoin_metrics?asset=usdc&sort=desc'

import http.client
import json

# Enter your Kaiko API Key
api_key = "KAIKO_API_KEY"
api_host = "us.market-api.kaiko.io"
api_base_endpoint = "/v2/data/analytics.v2/stablecoin_metrics"
# Start of mandatory parameter configuration
mandatory_params = {
    "asset": "usdc",
}
# End of mandatory parameter configuration
# Start of optional parameter configuration
optional_params = {
    #"start_time": "2024-08-27T13:13:53.441Z",
    #"end_time" : "2024-09-27T13:27:53.441Z",
    #"interval" : "1d",
    "sort":"desc",
}
# End of optional parameter configuration
conn = http.client.HTTPSConnection(api_host)
headers = {
    "X-Api-Key": api_key,
    "Accept": "application/json"
}

all_params = {**mandatory_params, **optional_params}

url_params = []
for param, value in all_params.items():
    url_params.append(f"{param}={value}")
url_params = '&'.join(url_params)

endpoint_with_params = f"{api_base_endpoint}?{url_params}"

# Pagination for next pages
all_data = []
next_url = endpoint_with_params
while next_url:
    conn.request("GET", next_url, headers=headers)
    response = conn.getresponse()
    data = json.loads(response.read().decode("utf-8"))
    all_data.extend(data.get("data", []))
    print(f"Fetched {len(data.get('data', []))} datapoints. Total: {len(all_data)}")
    next_url = data.get("next_url", "").replace("https://us.market-api.kaiko.io", "")
    if not next_url:
        break
conn.close()
print(f" datapoints fetched: {(all_data)}")

Response example

{
    "result": "success",
    "time": "2026-06-18T08:06:26Z",
    "timestamp": 1781769986999,
    "query":
    {
        "asset": "usdc",
        "end_time": "0001-01-01T00:00:00Z",
        "interval": "1d",
        "page_size": "10",
        "request_time": "2026-06-18T08:06:26.05808401Z",
        "sort": "desc",
        "start_time": "0001-01-01T00:00:00Z"
    },
    "data":
    [
        {
            "timestamp": "2026-06-18T00:00:00Z",
            "interval": "1d",
            "asset": "usdc",
            "price": 0.9997000899730081,
            "total_volume_usd": 796218091.3924453,
            "total_trade_count": 2000097,
            "cex_volume_usd": 694548754.6376011,
            "cex_trade_count": 1910473,
            "dex_volume_usd": 101669336.75484413,
            "dex_trade_count": 89624,
            "supply_circulating": 70051396209.43329,
            "market_cap": 70030387093.3053,
            "supply_change": -317149147.036026,
            "avg_weighted_defi_lending_yield": 0.030345222539145098,
            "avg_weighted_defi_borrowing_rate": 0.03869062376513863,
            "total_defi_deposited": 2321449893.228165,
            "total_defi_borrowed": 2030740561.2581594,
            "aggregated_buy_market_depth_asset": {
              "bid_volume_0_1": 410009275.917108,
              "bid_volume_0_2": 446428495.09170324,
              "bid_volume_0_5": 470849445.02862155,
              "bid_volume_1": 510576781.129591,
              "bid_volume_2": 549239689.7563232,
              "bid_volume_5": 549239689.7563232,
              "bid_volume_10": 629913837.648892
            },
            "aggregated_buy_market_depth_usd": {
              "bid_volume_0_1": 409964211.9019009,
              "bid_volume_0_2": 446379428.24938184,
              "bid_volume_0_5": 470797694.08590573,
              "bid_volume_1": 510520663.765471,
              "bid_volume_2": 549179322.9617518,
              "bid_volume_5": 599292340.4341673,
              "bid_volume_10": 629844603.9792498
            },
            "aggregated_sell_market_depth_asset": {
              "ask_volume_0_1": 311924899.9123604,
              "ask_volume_0_2": 327273471.225558,
              "ask_volume_0_5": 354299107.9406383,
              "ask_volume_1": 386901697.77497196,
              "ask_volume_2": 407012117.6172724,
              "ask_volume_5": 447660372.5945285,
              "ask_volume_10": 470660113.3308416
            },
            "aggregated_sell_market_depth_usd": {
              "ask_volume_0_1": 311890616.3259667,
              "ask_volume_0_2": 327237500.6815961,
              "ask_volume_0_5": 354260167.01582044,
              "ask_volume_1": 386859173.5077997,
              "ask_volume_2": 406967383.0189715,
              "ask_volume_5": 447611170.35686433,
              "ask_volume_10": 470608383.197524
            }
        },
        /* ALL RESULTS HERE */
    ],
    "continuation_token": "xxx",
    "next_url": "https://us.market-api.kaiko.io/v2/data/analytics.v2/stablecoin_metrics?continuation_token=xxx",
    "links":
    {
        "next": "/v2/data/analytics.v2/stablecoin_metrics?asset=usdc&end_time=2026-06-09T00%3A00%3A00Z&sort=desc"
    },
    "access":
    {
        "access_range":
        {
            "start_timestamp": 1073001600000,
            "end_timestamp": 1861830000000
        },
        "data_range":
        {
            "start_timestamp": "None",
            "end_timestamp": 1861830000000
        }
    }
}

PreviousAssets NextExchanges

Last updated 1 month ago

Was this helpful?