Market Data API

Access aggregated x402 ecosystem data. Free tier: 100 calls/day. With API key: 10,000 calls/day.

Base URL

https://kyvernlabs.com/api/v2/market

Authentication is optional. Add X-API-Key: kv_live_... header for higher rate limits.

GET/api/v2/market?metric=overview

Ecosystem summary: total volume, transactions, endpoints, agents, providers, avg price.

Parameters

range7d, 30d, 90d(default: 30d)

Response

{
  "metric": "overview",
  "range": "30d",
  "data": {
    "total_transactions": 226,
    "total_volume": 3.91,
    "active_endpoints": 19,
    "unique_agents": 12,
    "providers": 3,
    "avg_price": 0.0173
  }
}
GET/api/v2/market?metric=endpoints

Top 50 endpoints by volume with calls, revenue, avg price, unique agents.

Parameters

range7d, 30d, 90d(default: 30d)

Response

{
  "metric": "endpoints",
  "count": 19,
  "data": [
    { "endpoint": "/v1/translate", "calls": 70, "revenue": 0.21, "avg_price": 0.003, "unique_agents": 5 }
  ]
}
GET/api/v2/market?metric=volume

Daily transaction count and volume for charting.

Parameters

range7d, 30d, 90d(default: 30d)

Response

{
  "metric": "volume",
  "data": [
    { "date": "2026-04-01", "transactions": 15, "volume": 0.201 }
  ]
}
GET/api/v2/market?metric=categories

Endpoint categories with aggregated stats.

Parameters

range7d, 30d, 90d(default: 30d)

Response

{
  "metric": "categories",
  "data": [
    { "category": "AI / NLP", "calls": 108, "revenue": 0.644, "endpoints": 5 }
  ]
}
GET/api/v2/market?metric=pricing

Pricing analysis: avg, min, max price per endpoint.

Parameters

range7d, 30d, 90d(default: 30d)

Response

{
  "metric": "pricing",
  "data": [
    { "endpoint": "/v1/translate", "avg_price": 0.003, "min_price": 0.003, "max_price": 0.003, "sample_size": 70 }
  ]
}

Rate Limits

TierLimitAuth
Free100/dayNo key needed
Authenticated10,000/dayX-API-Key header
EnterpriseUnlimitedContact us