Stablecoin market data via x402 micropayment — circulating supply, chains, and peg info.
What it does
The `/defi/stablecoins` endpoint is part of the DeFi Intelligence API hosted at defi.hugen.tokyo. It returns aggregate stablecoin data including circulating supply figures (pegged USD values) and the chains each stablecoin is deployed on. The endpoint requires no query parameters — it is a simple GET request that returns a list of stablecoins with their metadata.
This endpoint is one of 26 DeFi-focused endpoints offered by the same API, which covers token security audits, bridge routing, protocol analytics, gas prices, TVL, DEX volume, and more. All endpoints use the x402 payment protocol: each call costs $0.01 USDC on Base (100 base units with 6 decimals). No API keys or rate limits are required; payment is handled per-call via the x402 challenge-response flow. Alternative access methods include a broker API (with a free API key providing $0.05 credit), an MCP server at mcp.hugen.tokyo, and a Python SDK (`x402-pay`).
The sample response embedded in the 402 challenge shows entries like USDT with ~$83 billion circulating supply across Ethereum and Tron. Response schemas are not formally defined in the OpenAPI spec (the 200 response schema is empty), so the exact shape must be inferred from the sample data in the payment challenge.
Capabilities
Use cases
- —Monitoring total stablecoin circulating supply across chains
- —Building dashboards that track stablecoin market composition
- —Agent-driven portfolio analysis that needs current stablecoin metrics
- —Comparing stablecoin deployment across L1/L2 networks
- —Feeding stablecoin data into DeFi risk models
Fit
Best for
- —AI agents needing on-demand stablecoin market snapshots via micropayment
- —Developers who want stablecoin data without managing API keys or subscriptions
- —Quick lookups of which chains a given stablecoin is deployed on
Not for
- —Historical time-series stablecoin data (endpoint appears to return current snapshots only)
- —Detailed per-address stablecoin balance queries
- —Free/bulk data ingestion — each call costs $0.01
Quick start
# Using the x402-pay Python SDK
pip install x402-pay
import x402_pay
response = x402_pay.get('https://defi.hugen.tokyo/defi/stablecoins')
print(response.json())Example
Response
{
"total": 100,
"stablecoins": [
{
"name": "USDT",
"chains": [
"Ethereum",
"Tron"
],
"circulating": {
"peggedUSD": 83000000000
}
}
]
}Endpoint
Quality
The endpoint is live (402 challenge captured with sample data), and a full OpenAPI spec is available for the broader API. However, the response schema for this specific endpoint is not formally defined — the 200 schema is empty. The sample response is inferred from the x402 challenge payload. No dedicated documentation page or pricing page exists beyond the Swagger UI.
Warnings
- —Response schema for /defi/stablecoins is not formally defined in the OpenAPI spec (empty schema object)
- —Sample response data is extracted from the 402 challenge payload and may not represent the full response structure
- —Root URL returns 404; no dedicated docs beyond auto-generated Swagger at /docs
Citations
- —The API describes itself as '26 DeFi security and data endpoints — token audits, bridge routing, protocol analytics' with x402 payment per callhttps://defi.hugen.tokyo/docs
- —The /defi/stablecoins endpoint is a GET with no required parametershttps://defi.hugen.tokyo/docs
- —Payment is $0.01 USDC on Base per call (100 base units)https://defi.hugen.tokyo/defi/stablecoins
- —Alternative access via broker, MCP, and x402-pay SDKhttps://defi.hugen.tokyo/defi/stablecoins
- —Sample stablecoin entry shows USDT with ~$83B circulating on Ethereum and Tronhttps://defi.hugen.tokyo/defi/stablecoins