Skip to main content

​
Introduction

The Circular API provides programmatic access to DeFi risk intelligence across Morpho Blue, Aave V3, and other lending protocols. It powers the Circular dashboard, MCP tools for Claude, and third-party integrations. Base URL: 
https://api.circular.rosetta.sh/api/v1

​
Quick Start

1. Get an API key from the Circular Dashboard or via the Client API. 2. Make your first request: 
curl -H "Authorization: Bearer circ_live_your_key_here" \
  https://api.circular.rosetta.sh/api/v1/markets?limit=5
3. Parse the response: 
{
  "data": [...],
  "meta": {
    "latencyMs": 142,
    "freshness": "live",
    "source": "morpho+aave"
  }
}

​
Response Envelope

Every successful response wraps data in a standard envelope:
FieldTypeDescription
dataanyThe endpoint-specific payload
meta.latencyMsnumberServer-side processing time
meta.freshnessstringData freshness indicator
meta.sourcestringWhich protocol(s) provided data

​
Endpoint Categories

CategoryTierEndpointsDescription
Core DataFree+19Markets, vaults, positions, liquidations, stats, health
Risk & AnalyticsPro+29Risk analysis, strategies, ratings, research
Portfolio ManagementFree+7Portfolio tracking, risk, yield, alerts
IntegrationsEnterprise8Agent risk API, client self-service

​
Financial Data Conventions

All monetary values are in USD. APYs are stored as decimals (0.042 = 4.2%). LLTV is normalized 0-1. Health factor >= 1 is safe, below 1 is liquidatable. TVL is supply-side only (never includes borrows).