llms-pro.txt

# DefiLlama Pro API (Paid)

> Pro API — requires a paid API key ($300/mo). Authentication: insert API key in URL path like https://pro-api.llama.fi/{YOUR_API_KEY}/endpoint. The pro-only endpoints below are NOT available on the free API.

Pro users can also call free endpoints with higher rate limits using the path mappings below.

## Free Endpoints Available on Pro (Higher Rate Limits)

Use base URL https://pro-api.llama.fi/{YOUR_API_KEY} with the pro path column.

| Free path (api.llama.fi) | Pro path (pro-api.llama.fi) | Description |
|---|---|---|
| `/protocols` | `/api/protocols` | List all protocols on defillama along with their tvl |
| `/protocol/{protocol}` | `/api/protocol/{protocol}` | Get historical TVL of a protocol and breakdowns by token and chain |
| `/v2/historicalChainTvl` | `/api/v2/historicalChainTvl` | Get historical TVL (excludes liquid staking and double counted tvl) of DeFi on all chains |
| `/v2/historicalChainTvl/{chain}` | `/api/v2/historicalChainTvl/{chain}` | Get historical TVL (excludes liquid staking and double counted tvl) of a chain |
| `/tvl/{protocol}` | `/api/tvl/{protocol}` | Simplified endpoint to get current TVL of a protocol |
| `/v2/chains` | `/api/v2/chains` | Get current TVL of all chains |
| `/prices/current/{coins}` | `/coins/prices/current/{coins}` | Get current prices of tokens by contract address |
| `/prices/historical/{timestamp}/{coins}` | `/coins/prices/historical/{timestamp}/{coins}` | Get historical prices of tokens by contract address |
| `/batchHistorical` | `/coins/batchHistorical` | Get historical prices for multiple tokens at multiple different timestamps |
| `/chart/{coins}` | `/coins/chart/{coins}` | Get token prices at regular time intervals |
| `/percentage/{coins}` | `/coins/percentage/{coins}` | Get percentage change in price over time |
| `/prices/first/{coins}` | `/coins/prices/first/{coins}` | Get earliest timestamp price record for coins |
| `/block/{chain}/{timestamp}` | `/coins/block/{chain}/{timestamp}` | Get the closest block to a timestamp |
| `/stablecoins` | `/stablecoins/stablecoins` | List all stablecoins along with their circulating amounts |
| `/stablecoincharts/all` | `/stablecoins/stablecoincharts/all` | Get historical mcap sum of all stablecoins |
| `/stablecoincharts/{chain}` | `/stablecoins/stablecoincharts/{chain}` | Get historical mcap sum of all stablecoins in a chain |
| `/stablecoin/{asset}` | `/stablecoins/stablecoin/{asset}` | Get historical mcap and historical chain distribution of a stablecoin |
| `/stablecoinchains` | `/stablecoins/stablecoinchains` | Get current mcap sum of all stablecoins on each chain |
| `/stablecoinprices` | `/stablecoins/stablecoinprices` | Get historical prices of all stablecoins |
| `/pools` | `/yields/pools` | Retrieve the latest data for all pools, including enriched information such as predictions |
| `/chart/{pool}` | `/yields/chart/{pool}` | Get historical APY and TVL of a pool |
| `/overview/dexs` | `/api/overview/dexs` | List all dexs along with summaries of their volumes and dataType history data |
| `/overview/dexs/{chain}` | `/api/overview/dexs/{chain}` | List all dexs along with summaries of their volumes and dataType history data filtering by chain |
| `/summary/dexs/{protocol}` | `/api/summary/dexs/{protocol}` | Get summary of dex volume with historical data |
| `/overview/options` | `/api/overview/options` | List all options dexs along with summaries of their volumes and dataType history data |
| `/overview/options/{chain}` | `/api/overview/options/{chain}` | List all options dexs along with summaries of their volumes and dataType history data filtering by chain |
| `/summary/options/{protocol}` | `/api/summary/options/{protocol}` | Get summary of options dex volume with historical data |
| `/overview/open-interest` | `/api/overview/open-interest` | List all open interest dex exchanges along with summaries of their open interest |
| `/overview/fees` | `/api/overview/fees` | List all protocols along with summaries of their fees and revenue and dataType history data |
| `/overview/fees/{chain}` | `/api/overview/fees/{chain}` | List all protocols along with summaries of their fees and revenue and dataType history data by chain |
| `/summary/fees/{protocol}` | `/api/summary/fees/{protocol}` | Get summary of protocol fees and revenue with historical data |

**Base URL for ALL endpoints below:** `https://pro-api.llama.fi`

## TVL

### GET /api/tokenProtocols/{symbol}
**Base URL:** `https://pro-api.llama.fi`
Lists the amount of a certain token within all protocols. Data for the Token Usage page

**Parameters:**
  - `symbol` (path, string, required) — token slug Example: `usdt`
Returns: array of {name, category, amountUsd}

### GET /api/inflows/{protocol}/{timestamp}
**Base URL:** `https://pro-api.llama.fi`
Lists the amount of inflows and outflows for a protocol at a given date

**Parameters:**
  - `protocol` (path, string, required) — protocol slug Example: `compound-v3`
  - `timestamp` (path, integer, required) — unix timestamp Example: `1767139200`
Returns: {outflows, oldTokens, currentTokens}

### GET /api/chainAssets
**Base URL:** `https://pro-api.llama.fi`
Get assets of all chains
Returns: {chain, timestamp}

---

## Stablecoins

### GET /stablecoins/stablecoindominance/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get stablecoin dominance per chain along with the info about the larges coin in a chain

**Parameters:**
  - `chain` (path, string, required) — chain slug, you can get these from /chains or the chains property on /protocols Example: `Ethereum`
  - `stablecoin` (query, integer, optional) — stablecoin ID, you can get these from /stablecoins Example: `1`
Returns: array of {date, totalCirculatingUSD, greatestMcap}

---

## Token Unlocks

### GET /api/emissions
**Base URL:** `https://pro-api.llama.fi`
List of all tokens along with basic info for each
Returns: array of {token, sources, protocolId, name, circSupply, circSupply30d, totalLocked, maxSupply, gecko_id, events, nextEvent, unlocksPerDay, mcap}

### GET /api/emission/{protocol}
**Base URL:** `https://pro-api.llama.fi`
Unlocks data for a given token/protocol. You can find a list of available slugs to query by querying /emissions and then extracting the key `gecko_id`

**Parameters:**
  - `protocol` (path, string, required) — protocol slug Example: `hyperliquid`
Returns: {body, lastModified}

---

## Protocol Analytics

### GET /api/categories
**Base URL:** `https://pro-api.llama.fi`
Overview of all categories accross all protocols
Returns: {chart, categories}

### GET /api/forks
**Base URL:** `https://pro-api.llama.fi`
Overview of all forks accross all protocols
Returns: {chart, forks}

### GET /api/oracles
**Base URL:** `https://pro-api.llama.fi`
Overview of all oracles accross all protocols
Returns: {chart, oracles, chainsByOracle}

### GET /api/hacks
**Base URL:** `https://pro-api.llama.fi`
Overview of all hacks on our Hacks dashboard
Returns: array of {date, name, classification, technique, amount, chain, bridgeHack, targetType, source, returnedFunds, defillamaId, language}

### GET /api/raises
**Base URL:** `https://pro-api.llama.fi`
Overview of all raises on our Raises dashboard
Returns: {raises}

### GET /api/treasuries
**Base URL:** `https://pro-api.llama.fi`
List all protocols on our Treasuries dashboard
Returns: array of {id, name, address, symbol, url, description, chain, logo, audits, audit_note, gecko_id, cmcId, category, chains, module, treasury, forkedFromIds, twitter, slug, tvl, chainTvls, change_1h, change_1d, change_7d, tokenBreakdowns, mcap}

### GET /api/entities
**Base URL:** `https://pro-api.llama.fi`
List all entities
Returns: array of {id, name, url, description, logo, category, module, twitter, symbol, chain, gecko_id, cmcId, chains, slug, tvl, chainTvls, change_1h, change_1d, change_7d, tokenBreakdowns, mcap}

---

## Token Liquidity

### GET /api/historicalLiquidity/{token}
**Base URL:** `https://pro-api.llama.fi`
Provides the name of contracts on a determined chain

**Parameters:**
  - `token` (path, string, required) — token slug Example: `usdt`

---

## Yields & APY

### GET /yields/poolsOld
**Base URL:** `https://pro-api.llama.fi`
Same as /pools but it also includes a new parameter `pool_old` which usually contains pool address (but not guaranteed)
Returns: {status, data}

### GET /yields/poolsBorrow
**Base URL:** `https://pro-api.llama.fi`
Borrow costs APY of assets from lending markets
Returns: {status, data}

### GET /yields/chartLendBorrow/{pool}
**Base URL:** `https://pro-api.llama.fi`
Historical borrow cost APY from a pool on a lending market, pool ids should be obtained from /poolsBorrow

**Parameters:**
  - `pool` (path, string, required) — pool id, can be retrieved from /poolsBorrow (property is called pool) Example: `e880e828-ca59-4ec6-8d4f-27182a4dc23d`
Returns: {status, data}

### GET /yields/perps
**Base URL:** `https://pro-api.llama.fi`
Funding rates and Open Interest of perps across exchanges, including both Decentralized and Centralized
Returns: {status, data}

### GET /yields/lsdRates
**Base URL:** `https://pro-api.llama.fi`
APY rates of multiple LSDs
Returns: array of {name, symbol, address, type, expectedRate, marketRate, ethPeg, fee}

---

## ETFs

### GET /etfs/snapshot
**Base URL:** `https://pro-api.llama.fi`
Get ETFs and their metrics (aum, flows, fees...)
Returns: array of {ticker, timestamp, asset, issuer, etf_name, custodian, pct_fee, url, flows, aum, volume}

### GET /etfs/flows
**Base URL:** `https://pro-api.llama.fi`
Historical Flows at the Asset Level
Returns: array of {gecko_id, day, total_flow_usd}

---

## Narratives

### GET /fdv/performance/{period}
**Base URL:** `https://pro-api.llama.fi`
Get chart of narratives based on category performance (with individual coins weighted by mcap)

**Parameters:**
  - `period` (path, string, required) — One of ['7', '30', 'ytd', '365'] Example: `30`
Returns: array of {date, Analytics, Artificial Intelligence (AI), Bitcoin, Bridge Governance Tokens, Centralized Exchange (CEX) Token, Data Availability, Decentralized Finance (DeFi), Decentralized Identifier (DID), DePIN, Ethereum, Gaming (GameFi), Liquid Staking Governance Tokens, Meme, NFT Marketplace, Oracle, PolitiFi, Prediction Markets, Real World Assets (RWA), Rollup, Smart Contract Platform, SocialFi, Solana}

---

## Perpetuals & Open Interest

### GET /api/overview/derivatives
**Base URL:** `https://pro-api.llama.fi`
Lists all derivatives along summaries of their volumes filtering by chain

**Parameters:**
  - `excludeTotalDataChart` (query, boolean, required) — true to exclude aggregated chart from response Example: `true`
  - `excludeTotalDataChartBreakdown` (query, boolean, required) — true to exclude broken down chart from response Example: `true`
Returns: {totalDataChart, totalDataChartBreakdown, breakdown24h, breakdown30d, chain, allChains, total24h, total48hto24h, total7d, total14dto7d, total60dto30d, total30d, total1y, change_1d, change_7d, change_1m, change_7dover7d, change_30dover30d, total7DaysAgo, total30DaysAgo, totalAllTime, protocols}

### GET /api/summary/derivatives/{protocol}
**Base URL:** `https://pro-api.llama.fi`
Volume Details about a specific perp protocol

**Parameters:**
  - `protocol` (path, string, required) — protocol slug Example: `hyperliquid`
  - `excludeTotalDataChart` (query, boolean, required) — true to exclude aggregated chart from response Example: `true`
  - `excludeTotalDataChartBreakdown` (query, boolean, required) — true to exclude broken down chart from response Example: `true`
Returns: {id, name, url, referralUrl, description, logo, gecko_id, cmcId, chains, twitter, github, symbol, address, childProtocols, linkedProtocols, defillamaId, disabled, displayName, module, category, methodologyURL, methodology, forkedFrom, audits, audit_links, versionKey, governanceID, treasury, parentProtocol, previousNames, latestFetchIsOk, slug, protocolType, total24h, total48hto24h, total7d, totalAllTime, totalDataChart, totalDataChartBreakdown, change_1d}

---

## Bridges

### GET /bridges/bridges
**Base URL:** `https://pro-api.llama.fi`
List all bridges along with summaries of recent bridge volumes.

**Parameters:**
  - `includeChains` (query, boolean, optional) — set whether to include current previous day volume breakdown by chain Example: `true`
Returns: {bridges}

### GET /bridges/bridge/{id}
**Base URL:** `https://pro-api.llama.fi`
Get summary of bridge volume and volume breakdown by chain

**Parameters:**
  - `id` (path, integer, required) — bridge ID, you can get these from /bridges Example: `1`
Returns: {id, name, displayName, lastHourlyVolume, currentDayVolume, lastDailyVolume, dayBeforeLastVolume, weeklyVolume, monthlyVolume, lastHourlyTxs, currentDayTxs, prevDayTxs, dayBeforeLastTxs, weeklyTxs, monthlyTxs, chainBreakdown, destinationChain}

### GET /bridges/bridgevolume/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get historical volumes for a bridge, chain, or bridge on a particular chain

**Parameters:**
  - `chain` (path, string, required) — chain slug, you can get these from /chains. Call also use 'all' for volume on all chains. Example: `Ethereum`
  - `id` (query, integer, optional) — bridge ID, you can get these from /bridges Example: `2`
Returns: array of {date, depositUSD, withdrawUSD, depositTxs, withdrawTxs}

### GET /bridges/bridgedaystats/{timestamp}/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get a 24hr token and address volume breakdown for a bridge

**Parameters:**
  - `timestamp` (path, integer, required) — Unix timestamp. Data returned will be for the 24hr period starting at 00:00 UTC that the timestamp lands in. Example: `1755561600`
  - `chain` (path, string, required) — chain slug, you can get these from /chains. Example: `Ethereum`
  - `id` (query, integer, optional) — bridge ID, you can get these from /bridges Example: `2`
Returns: {date, totalTokensDeposited, totalTokensWithdrawn, totalAddressDeposited, totalAddressWithdrawn}

### GET /bridges/transactions/{id}
**Base URL:** `https://pro-api.llama.fi`
Get all transactions for a bridge within a date range

**Parameters:**
  - `id` (path, integer, required) — bridge ID, you can get these from /bridges Example: `1`
  - `starttimestamp` (query, integer, optional) — start timestamp (Unix Timestamp) for date range Example: `1667260800`
  - `endtimestamp` (query, integer, optional) — end timestamp (Unix timestamp) for date range Example: `1667347200`
  - `sourcechain` (query, string, optional) — Returns only transactions that are bridging from the specified source chain. Example: `Polygon`
  - `address` (query, string, optional) — Returns only transactions with specified address as "from" or "to". Addresses are quried in the form {chain}:{address}, where chain is an identifier such as ethereum, bsc, polygon, avax... . Example: `ethereum:0x69b4B4390Bd1f0aE84E090Fe8af7AbAd2d95Cc8E`
  - `limit` (query, integer, optional) — limit to number of transactions returned, maximum is 6000 Example: `200`

---

## API Key Management

### GET /usage/APIKEY
**Base URL:** `https://pro-api.llama.fi`
Get amount of credits left in the api key, these reset on the 1st of each month

---

## Digital Asset Treasury

### GET /dat/institutions
**Base URL:** `https://pro-api.llama.fi`
Get list of all institutions with Digital Asset Treasury data
Returns: {institutionMetadata, assetMetadata, institutions, assets, totalCompanies, flows, mNAV, lastUpdated}

### GET /dat/institutions/{symbol}
**Base URL:** `https://pro-api.llama.fi`
Get individual institution Digital Asset Treasury details

**Parameters:**
  - `symbol` (path, string, required) — Institution ticker symbol (e.g., MSTR for MicroStrategy) Example: `MSTR`
Returns: {institutionId, ticker, name, type, rank, price, priceChange24h, volume24h, fd_realized, fd_realistic, fd_max, mcap_realized, mcap_realistic, mcap_max, realized_mNAV, realistic_mNAV, max_mNAV, totalCost, totalUsdValue, assets, assetsMeta, ohlcv, assetValue, stats, transactions, lastUpdated}

---

## Equities (beta)

> **Beta:** The Equities endpoints are in beta. Behavior, parameters, and response shapes may change.

Data provided by [Twelve Data](https://twelvedata.com/).

### GET /equities/v1/companies-list
**Base URL:** `https://pro-api.llama.fi`
Get list of all tracked public companies. Use this to discover valid `ticker` + `country` pairs for the other equities endpoints.
Returns: array of tracked companies, each `{ticker, companyName, country (ISO 3166-1 alpha-2), countryName}`

### GET /equities/v1/statements
**Base URL:** `https://pro-api.llama.fi`
Get financial statements for a company

**Parameters:**
  - `ticker` (query, string, required) — Stock ticker symbol (case-insensitive) Example: `COIN`
  - `country` (query, string, required) — Two-letter country code (ISO 3166-1 alpha-2) identifying the market where the company is listed. Used together with `ticker` to uniquely identify a company, since the same ticker can exist in different markets. Must match a `country` value from `GET /equities/v1/companies-list` (case-insensitive). Example: `US`
Returns: income statement, balance sheet, and cash flow statement for the ticker, each broken down by quarterly and annual periods. `{incomeStatement, balanceSheet, cashflow}`

### GET /equities/v1/dimensions
**Base URL:** `https://pro-api.llama.fi`
Get financial dimensions for a company

**Parameters:**
  - `ticker` (query, string, required) — Stock ticker symbol (case-insensitive) Example: `COIN`
  - `country` (query, string, required) — Two-letter country code (ISO 3166-1 alpha-2) identifying the market where the company is listed. Used together with `ticker` to uniquely identify a company, since the same ticker can exist in different markets. Must match a `country` value from `GET /equities/v1/companies-list` (case-insensitive). Example: `US`
Returns: time-series financial dimension metrics (such as revenue, holders revenue, and earnings), each split into annual and quarterly series. Every data point is a two-element array `[date, value]` (ISO 8601 period-ending date, then numeric value), sorted by date descending (newest first).

### GET /equities/v1/price-history
**Base URL:** `https://pro-api.llama.fi`
Get historical price data for a company

**Parameters:**
  - `ticker` (query, string, required) — Stock ticker symbol (case-insensitive) Example: `AAPL`
  - `country` (query, string, required) — Two-letter country code (ISO 3166-1 alpha-2) identifying the market where the company is listed. Used together with `ticker` to uniquely identify a company, since the same ticker can exist in different markets. Must match a `country` value from `GET /equities/v1/companies-list` (case-insensitive). Example: `US`
  - `timeframe` (query, string, optional) — Optional lookback window (case-insensitive). Omit or empty for full history (`MAX`). (one of: 1W, 1M, 6M, 1Y, 5Y, MAX) Example: `1Y`
Returns: array of daily closing prices, each a two-element array `[timestamp, price]` (ISO 8601 date-time string, then numeric closing price). Sorted by date descending (newest first).

### GET /equities/v1/ohlcv
**Base URL:** `https://pro-api.llama.fi`
Get OHLCV candle data for a company

**Parameters:**
  - `ticker` (query, string, required) — Stock ticker symbol (case-insensitive) Example: `AAPL`
  - `country` (query, string, required) — Two-letter country code (ISO 3166-1 alpha-2) identifying the market where the company is listed. Used together with `ticker` to uniquely identify a company, since the same ticker can exist in different markets. Must match a `country` value from `GET /equities/v1/companies-list` (case-insensitive). Example: `US`
  - `timeframe` (query, string, optional) — Optional lookback window (case-insensitive). Same values as price history. Omit or empty for full history (`MAX`). (one of: 1W, 1M, 6M, 1Y, 5Y, MAX) Example: `6M`
Returns: array of daily OHLCV bars, each a six-number array `[timestamp, open, high, low, close, volume]` where `timestamp` is Unix epoch seconds (UTC). Sorted by time descending (newest first).

### GET /equities/v1/summary
**Base URL:** `https://pro-api.llama.fi`
Get live market summary for a company

**Parameters:**
  - `ticker` (query, string, required) — Stock ticker symbol (case-insensitive) Example: `AAPL`
  - `country` (query, string, required) — Two-letter country code (ISO 3166-1 alpha-2) identifying the market where the company is listed. Used together with `ticker` to uniquely identify a company, since the same ticker can exist in different markets. Must match a `country` value from `GET /equities/v1/companies-list` (case-insensitive). Example: `US`
Returns: compact live market snapshot for the ticker (no `ticker`/`name` fields; use `GET /equities/v1/companies-list` for company identity). {currentPrice, volume, marketCap, circulatingMarketCap, enterpriseValue, fiftyTwoWeekHigh, fiftyTwoWeekLow, dividendYield, trailingPE, priceToRevenue, priceChangePercentage1d, priceChangePercentage7d, priceChangePercentage1m, priceChange1d, marketCapChange1d, priceToBook, enterpriseValueToEbitda, holdersYield, updatedAt, revenueTTM, grossProfitTTM, earningsTTM, ebitdaTTM, operatingProfitMarginTTM, holdersRevenueTTM, holderEarningsTTM, dividendsTTM, stockRepurchaseTTM, stockIssuanceTTM, stockBasedCompensationTTM, cashAndCashEquivalents, totalAssets, totalLiabilities, totalShareholdersEquity, totalDebt, circulatingSupply, totalSupply, employeeCount}

### GET /equities/v1/filings
**Base URL:** `https://pro-api.llama.fi`
Get company filings for a company (e.g. annual reports, quarterly reports, and other important filings)

**Parameters:**
  - `ticker` (query, string, required) — Stock ticker symbol (case-insensitive) Example: `COIN`
  - `country` (query, string, required) — Two-letter country code (ISO 3166-1 alpha-2) identifying the market where the company is listed. Used together with `ticker` to uniquely identify a company, since the same ticker can exist in different markets. Must match a `country` value from `GET /equities/v1/companies-list` (case-insensitive). Example: `US`
Returns: array of filings, each `{filingDate, reportDate, form, primaryDocumentUrl, documentDescription}` (`form` is the filing type, e.g. annual or quarterly report). Sorted by filing date descending (newest first).

---

## Oracles (Beta)

### GET /api/v2/metrics/oracle
**Base URL:** `https://pro-api.llama.fi`
Get oracle data overview. Returns mapping of oracle names to arrays of protocol names using that oracle.
Returns: {oracles: {OracleName: [protocol1, protocol2, ...], ...}}

### GET /api/v2/chart/oracle
**Base URL:** `https://pro-api.llama.fi`
Get timeseries chart data for all oracles. Returns array of [timestamp, value] pairs representing total oracle TVL over time.
Returns: array of [timestamp, value]

### GET /api/v2/chart/oracle/chain-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get timeseries chart data breakdown by chain. Returns array of objects with timestamp and TVL per chain.
Returns: array of {timestamp, Chain1: value, Chain2: value, ...}

### GET /api/v2/chart/oracle/protocol-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get timeseries chart data breakdown by protocol/oracle. Returns array of objects with timestamp and TVL per oracle.
Returns: array of {timestamp, Oracle1: value, Oracle2: value, ...}

### GET /api/v2/chart/oracle/protocol/{protocol}
**Base URL:** `https://pro-api.llama.fi`
Get timeseries chart data by protocol/oracle. Returns array of [timestamp, value] pairs for a specific oracle.

**Parameters:**
  - `protocol` (path, string, required) — oracle/protocol name Example: `Chainlink`
Returns: array of [timestamp, value]

### GET /api/v2/chart/oracle/protocol/{protocol}/chain-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get chain breakdown timeseries chart data by protocol/oracle. Returns array of objects with timestamp and TVL per chain for a specific oracle.

**Parameters:**
  - `protocol` (path, string, required) — oracle/protocol name Example: `Chainlink`
Returns: array of {timestamp, Chain1: value, Chain2: value, ...}

### GET /api/v2/chart/oracle/chain/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get timeseries chart data by chain. Returns array of [timestamp, value] pairs for oracle TVL on a specific chain.

**Parameters:**
  - `chain` (path, string, required) — chain name Example: `Ethereum`
Returns: array of [timestamp, value]

### GET /api/v2/chart/oracle/chain/{chain}/protocol-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get protocol breakdown timeseries chart data by chain. Returns array of objects with timestamp and TVL per oracle for a specific chain.

**Parameters:**
  - `chain` (path, string, required) — chain name Example: `Ethereum`
Returns: array of {timestamp, Oracle1: value, Oracle2: value, ...}

---

## Forks (Beta)

### GET /api/v2/metrics/fork
**Base URL:** `https://pro-api.llama.fi`
Get fork data overview. Returns mapping of fork protocol names to arrays of forked protocol names.
Returns: {ForkName: [protocol1, protocol2, ...], ...}

### GET /api/v2/chart/fork/protocol-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get timeseries chart data breakdown by protocol. Returns array of objects with timestamp and TVL per fork protocol.
Returns: array of {timestamp, Fork1: value, Fork2: value, ...}

### GET /api/v2/chart/fork/protocol/{protocol}
**Base URL:** `https://pro-api.llama.fi`
Get timeseries chart data by protocol. Returns array of [timestamp, value] pairs for all forks of a specific protocol.

**Parameters:**
  - `protocol` (path, string, required) — protocol slug Example: `aave-v3`
Returns: array of [timestamp, value]

---

## Dimensions (Beta)

Unified dimension endpoints for fees, liquidations, DEX volumes, derivatives, options, aggregators, bridge aggregators, open interest, and normalized volume.

**`{metric}` values:** fees, liquidations, dexs, derivatives, options, aggregators, bridge-aggregators, open-interest, normalized-volume

**`dataType` query parameter** (optional, metric-specific):
- **fees**: dailyFees (default), dailyRevenue, dailySupplySideRevenue, dailyHoldersRevenue, dailyProtocolRevenue
- **liquidations**: dailyLiquidationsVolume (default), dailyCollateralLiquidated
- **dexs**: dailyVolume (default), dailyNotionalVolume
- **derivatives**: dailyVolume (default), dailyNotionalVolume
- **options**: dailyNotionalVolume (default), dailyPremiumVolume
- **aggregators**: dailyVolume (default)
- **bridge-aggregators**: dailyBridgeVolume (default)
- **open-interest**: openInterestAtEnd (default), shortOpenInterestAtEnd, longOpenInterestAtEnd
- **normalized-volume**: dailyNormalizedVolume (default), dailyActiveLiquidity

**`{protocol}`** should be slug-formatted (e.g. `aave`, `hyperliquid-perps`, `openocean`, `li.fi-bridge-aggregator`)
**`{category}`** should be slug-formatted (e.g. `dexs`, `prediction-market`, `options`, `dex-aggregator`, `bridge-aggregator`)

### Overview

#### GET /api/v2/metrics/{metric}
**Base URL:** `https://pro-api.llama.fi`
Get dimension data overview. Returns aggregate metrics including totals and percentage changes.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `dataType` (query, string, optional) — metric-specific data type
  - Supports `metric=active-users` with `dataType` values: dailyActiveUsers (default), dailyTransactionCount, dailyGasUsed
Returns: {allChains, total24h, total48hto24h, total7d, total14dto7d, total60dto30d, total30d, total1y, change_1d, change_7d, change_1m, change_7dover7d, change_30dover30d}

#### GET /api/v2/chart/{metric}
**Base URL:** `https://pro-api.llama.fi`
Get historical timeseries chart data.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `dataType` (query, string, optional) — metric-specific data type
  - Supports `metric=active-users` with `dataType` values: dailyActiveUsers (default), dailyTransactionCount, dailyGasUsed
Returns: array of [timestamp, value]

#### GET /api/v2/chart/{metric}/chain-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get historical timeseries chart data breakdown by chain.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `dataType` (query, string, optional) — metric-specific data type
  - Supports `metric=active-users` with `dataType` values: dailyActiveUsers (default), dailyTransactionCount, dailyGasUsed
Returns: array of [timestamp, {Chain1: value, Chain2: value, ...}]

#### GET /api/v2/chart/{metric}/protocol-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get historical timeseries chart data breakdown by protocol.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Protocol1: value, Protocol2: value, ...}]

### For chains

#### GET /api/v2/metrics/{metric}/chain/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get chain dimension data overview.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `chain` (path, string, required) — chain name Example: `Ethereum`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: {chain, allChains, total24h, total48hto24h, total7d, total14dto7d, total60dto30d, total30d, total1y, change_1d, change_7d, change_1m, change_7dover7d, change_30dover30d}

#### GET /api/v2/chart/{metric}/chain/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get chain historical timeseries chart data.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `chain` (path, string, required) — chain name Example: `Ethereum`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, value]

#### GET /api/v2/chart/{metric}/chain/{chain}/protocol-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get chain timeseries chart data breakdown by protocol.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `chain` (path, string, required) — chain name Example: `Ethereum`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Protocol1: value, Protocol2: value, ...}]

### For protocols

#### GET /api/v2/metrics/{metric}/protocol/{protocol}
**Base URL:** `https://pro-api.llama.fi`
Get protocol dimension data overview. Returns protocol metadata along with aggregate metrics.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `protocol` (path, string, required) — protocol slug Example: `aave`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: {id, name, url, description, logo, chains, gecko_id, cmcId, symbol, total24h, total48hto24h, total7d, total30d, total1y, change_1d, change_7d, change_1m}

#### GET /api/v2/chart/{metric}/protocol/{protocol}
**Base URL:** `https://pro-api.llama.fi`
Get protocol historical timeseries chart data.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `protocol` (path, string, required) — protocol slug Example: `aave`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, value]

#### GET /api/v2/chart/{metric}/protocol/{protocol}/chain-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get protocol timeseries chart data breakdown by chain.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `protocol` (path, string, required) — protocol slug Example: `aave`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Chain1: value, Chain2: value, ...}]

#### GET /api/v2/chart/{metric}/protocol/{protocol}/version-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get protocol timeseries chart data breakdown by version (e.g. Aave V2, Aave V3).

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `protocol` (path, string, required) — protocol slug Example: `aave`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Version1: value, Version2: value, ...}]

#### GET /api/v2/chart/{metric}/protocol/{protocol}/label-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get protocol timeseries chart data breakdown by label (e.g. Borrow Interest, Flash Loans). Currently only supported for metric=fees.

**Parameters:**
  - `metric` (path, string, required) — must be `fees` Example: `fees`
  - `protocol` (path, string, required) — protocol slug Example: `aave`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Label1: value, Label2: value, ...}]

### For categories

#### GET /api/v2/metrics/{metric}/category/{category}
**Base URL:** `https://pro-api.llama.fi`
Get category dimension data overview.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `category` (path, string, required) — category slug Example: `dexs`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: {category, allCategories, allChains, total24h, total48hto24h, total7d, total14dto7d, total60dto30d, total30d, total1y, change_1d, change_7d, change_1m, change_7dover7d, change_30dover30d}

#### GET /api/v2/chart/{metric}/category/{category}
**Base URL:** `https://pro-api.llama.fi`
Get category historical timeseries chart data.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `category` (path, string, required) — category slug Example: `dexs`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, value]

#### GET /api/v2/chart/{metric}/category/{category}/chain-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get category timeseries chart data breakdown by chain.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `category` (path, string, required) — category slug Example: `dexs`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Chain1: value, Chain2: value, ...}]

#### GET /api/v2/chart/{metric}/category/{category}/protocol-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get category timeseries chart data breakdown by protocol.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `category` (path, string, required) — category slug Example: `dexs`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Protocol1: value, Protocol2: value, ...}]

### For categories and chains

#### GET /api/v2/metrics/{metric}/category/{category}/chain/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get category chain dimension data overview.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `category` (path, string, required) — category slug Example: `dexs`
  - `chain` (path, string, required) — chain name Example: `Ethereum`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: {category, chain, allCategories, allChains, total24h, total48hto24h, total7d, total14dto7d, total60dto30d, total30d, total1y, change_1d, change_7d, change_1m, change_7dover7d}

#### GET /api/v2/chart/{metric}/category/{category}/chain/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get category chain historical timeseries chart data.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `category` (path, string, required) — category slug Example: `dexs`
  - `chain` (path, string, required) — chain name Example: `Ethereum`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, value]

#### GET /api/v2/chart/{metric}/category/{category}/chain/{chain}/protocol-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get category chain timeseries chart data breakdown by protocol.

**Parameters:**
  - `metric` (path, string, required) — dimension metric type Example: `fees`
  - `category` (path, string, required) — category slug Example: `dexs`
  - `chain` (path, string, required) — chain name Example: `Ethereum`
  - `dataType` (query, string, optional) — metric-specific data type
Returns: array of [timestamp, {Protocol1: value, Protocol2: value, ...}]

---

## Real World Assets

### GET /rwa/current
**Base URL:** `https://pro-api.llama.fi`
List all current RWA assets with per-chain onchain market cap, active market cap, and DeFi active TVL maps.
Returns: array of RWA asset objects

### GET /rwa/stats
**Base URL:** `https://pro-api.llama.fi`
Get aggregate RWA stats by chain, category, platform, and asset group. For the default per-chain table, read `byChain[chain].base`: `assetIssuers.length`, `assetCount`, `activeMcap`, `onChainMcap`, and `defiActiveTvl`. Add `stablecoinsOnly`, `governanceOnly`, and `stablecoinsAndGovernance` when those buckets should be included.
Returns: {totalOnChainMcap, totalActiveMcap, totalDefiActiveTvl, assetCount, assetIssuers, byChain, byCategory, byPlatform, byAssetGroup}

### GET /rwa/list
**Base URL:** `https://pro-api.llama.fi`
List RWA canonical market ids, platforms, chains, categories, asset groups, and id mappings.
Returns: {canonicalMarketIds, platforms, chains, categories, assetGroups, idMap}

### GET /rwa/chain/{chain}
**Base URL:** `https://pro-api.llama.fi`
List current RWA assets on a chain.

**Parameters:**
  - `chain` (path, string, required) — chain display name, case-insensitive Example: `Ethereum`
Returns: {data}

### GET /rwa/chart/chain/{chain}
**Base URL:** `https://pro-api.llama.fi`
Get historical RWA onchain market cap, active market cap, and DeFi active TVL totals for a chain.

**Parameters:**
  - `chain` (path, string, required) — chain display name Example: `Ethereum`
Returns: array of {timestamp, onChainMcap, activeMcap, defiActiveTvl}

### GET /rwa/chart/chain-breakdown
**Base URL:** `https://pro-api.llama.fi`
Get historical RWA metric breakdown by chain.

**Parameters:**
  - `key` (query, string, optional) — metric to break down by chain, defaults to `onChainMcap` (one of: onChainMcap, activeMcap, defiActiveTvl) Example: `activeMcap`
  - `includeStablecoin` (query, boolean, optional) — include stablecoin-token assets in chart totals Example: `false`
  - `includeGovernance` (query, boolean, optional) — include governance-token assets in chart totals Example: `false`
Returns: array of {timestamp, [chain]: value}

---

## Financial Statements (Beta)

### GET /api/v2/metrics/financial-statement/protocol/{protocol}
**Base URL:** `https://pro-api.llama.fi`
Get protocol income statement report. Returns protocol metadata, methodology details, and aggregated financial data (yearly, quarterly, monthly).

When querying a **parent protocol** (e.g. `aave`), the response includes `childProtocols` with per-version methodology. When querying a **child protocol** (e.g. `aave-v3`), `methodology` and `breakdownMethodology` are at the top level.

Each time period contains line items such as:
- **Gross Protocol Revenue** — total fees collected (with label breakdown e.g. Borrow Interest, Liquidation Fees, Flashloan Fees)
- **Cost Of Revenue** — fees distributed to suppliers/LPs
- **Gross Profit** — revenue minus cost of revenue
- **Token Holder Net Income** — value accruing to token holders (e.g. buybacks)
- **Incentives** — token incentives distributed (e.g. staking rewards, lending rewards)
- **Earnings** — net earnings after incentives

Each line item has a `value` (total USD) and optional `by-label` object breaking down by revenue source.

**Parameters:**
  - `protocol` (path, string, required) — protocol slug Example: `aave-v3`
Returns: {id, name, address, symbol, url, description, chain?, logo, audits?, audit_links?, category?, chains, oraclesBreakdown?, module?, twitter, github?, listedAt?, parentProtocol?, dimensions?, methodology?, breakdownMethodology?, methodologyURL?, tvlCodePath?, hallmarks?, linkedProtocols, childProtocols?, hasLabelBreakdown, defillamaId, displayName, slug, protocolType, aggregates: {yearly: {period: {LineItem: {value, by-label?}}}, quarterly: {...}, monthly: {...}}}