From 21514cbe567a9359ecadfc9306c6a9088c062f68 Mon Sep 17 00:00:00 2001 From: bheluga Date: Sun, 8 Mar 2026 15:14:05 +0530 Subject: [PATCH 1/2] add equities' endpoints --- defillama-openapi-pro.json | 259 +++++++++++++++++++++++++++++++++++++ llms.txt | 99 ++++++++++++++ 2 files changed, 358 insertions(+) diff --git a/defillama-openapi-pro.json b/defillama-openapi-pro.json index c5948d7d456..b1e188483c8 100644 --- a/defillama-openapi-pro.json +++ b/defillama-openapi-pro.json @@ -71,6 +71,10 @@ { "name": "DAT", "description": "Digital Asset Treasury" + }, + { + "name": "Equities", + "description": "Stock market data for publicly traded companies" } ], "paths": { @@ -9079,6 +9083,261 @@ } ] } + }, + "/equities/v1/companies": { + "get": { + "tags": ["Equities"], + "x-scalar-tier": "pro", + "x-api-plan-only": true, + "x-scalar-stability": "beta", + "summary": "List all tracked public companies", + "description": "Returns a list of all publicly traded companies tracked by DefiLlama, with current market summary data for each.", + "security": [{ "ApiKeyAuth": [] }], + "responses": { + "200": { + "description": "Successful operation", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "ticker": { "type": "string", "example": "COIN" }, + "name": { "type": "string", "example": "Coinbase Global Inc." }, + "currentPrice": { "type": "number", "example": 125.5 }, + "volume": { "type": "number", "example": 25000000 }, + "marketCap": { "type": "number", "example": 50000000000 }, + "priceChangePercentage": { "type": "number", "example": 2.5 }, + "lastUpdatedAt": { + "type": "string", + "format": "date-time", + "example": "2025-03-08T12:00:00.000Z" + } + } + } + } + } + } + }, + "401": { "description": "Unauthorized" }, + "500": { "description": "Internal server error" } + } + } + }, + "/equities/v1/statements": { + "get": { + "tags": ["Equities"], + "x-scalar-tier": "pro", + "x-api-plan-only": true, + "x-scalar-stability": "beta", + "summary": "Get full financial statements for a company", + "description": "Returns normalized income statement, balance sheet, and cash flow statement for the given ticker, broken down by quarterly and annual periods.", + "security": [{ "ApiKeyAuth": [] }], + "parameters": [ + { + "name": "ticker", + "in": "query", + "description": "Stock ticker symbol (case-insensitive)", + "required": true, + "schema": { "type": "string", "example": "COIN" } + } + ], + "responses": { + "200": { + "description": "Successful operation", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "incomeStatement": { + "type": "object", + "properties": { + "labels": { "type": "array", "items": { "type": "string" } }, + "quarterly": { + "type": "object", + "properties": { + "periods": { + "type": "array", + "items": { "type": "string" }, + "example": ["2024-Q1", "2024-Q2"] + }, + "periodEnding": { + "type": "array", + "items": { "type": "string" }, + "example": ["2024-03-31", "2024-06-30"] + }, + "values": { "type": "array", "items": { "type": "array", "items": { "type": "number" } } } + } + }, + "annual": { + "type": "object", + "properties": { + "periods": { "type": "array", "items": { "type": "string" }, "example": ["2023", "2024"] }, + "periodEnding": { + "type": "array", + "items": { "type": "string" }, + "example": ["2023-12-31", "2024-12-31"] + }, + "values": { "type": "array", "items": { "type": "array", "items": { "type": "number" } } } + } + } + } + }, + "balanceSheet": { "type": "object" }, + "cashflow": { "type": "object" } + } + } + } + } + }, + "400": { "description": "Missing required ticker parameter" }, + "401": { "description": "Unauthorized" }, + "404": { "description": "Ticker not found" }, + "500": { "description": "Internal server error" } + } + } + }, + "/equities/v1/price-history": { + "get": { + "tags": ["Equities"], + "x-scalar-tier": "pro", + "x-api-plan-only": true, + "x-scalar-stability": "beta", + "summary": "Get historical price data for a company", + "description": "Returns an array of daily closing prices for the given ticker, sorted from oldest to newest.", + "security": [{ "ApiKeyAuth": [] }], + "parameters": [ + { + "name": "ticker", + "in": "query", + "description": "Stock ticker symbol (case-insensitive)", + "required": true, + "schema": { "type": "string", "example": "COIN" } + } + ], + "responses": { + "200": { + "description": "Successful operation", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "date": { "type": "string", "format": "date", "example": "2024-12-31" }, + "price": { "type": "number", "example": 125.5 } + } + } + } + } + } + }, + "400": { "description": "Missing required ticker parameter" }, + "401": { "description": "Unauthorized" }, + "404": { "description": "Prices not found for ticker" }, + "500": { "description": "Internal server error" } + } + } + }, + "/equities/v1/summary": { + "get": { + "tags": ["Equities"], + "x-scalar-tier": "pro", + "x-api-plan-only": true, + "x-scalar-stability": "beta", + "summary": "Get live market summary for a company", + "description": "Returns current market data for the given ticker including price, volume, market cap, 52-week range, dividend yield, and P/E ratio.", + "security": [{ "ApiKeyAuth": [] }], + "parameters": [ + { + "name": "ticker", + "in": "query", + "description": "Stock ticker symbol (case-insensitive)", + "required": true, + "schema": { "type": "string", "example": "COIN" } + } + ], + "responses": { + "200": { + "description": "Successful operation", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "currentPrice": { "type": "number", "example": 125.5 }, + "volume": { "type": "number", "example": 25000000 }, + "marketCap": { "type": "number", "example": 50000000000 }, + "fiftyTwoWeekHigh": { "type": "number", "example": 150.75 }, + "fiftyTwoWeekLow": { "type": "number", "example": 90.25 }, + "dividendYield": { "type": "number", "example": 0.025 }, + "trailingPE": { "type": "number", "example": 28.5 }, + "priceChangePercentage": { "type": "number", "example": 2.5 }, + "updatedAt": { "type": "string", "format": "date-time", "example": "2025-03-08T12:00:00.000Z" } + } + } + } + } + }, + "400": { "description": "Missing required ticker parameter" }, + "401": { "description": "Unauthorized" }, + "404": { "description": "Summary not found for ticker" }, + "500": { "description": "Internal server error" } + } + } + }, + "/equities/v1/filings": { + "get": { + "tags": ["Equities"], + "x-scalar-tier": "pro", + "x-api-plan-only": true, + "x-scalar-stability": "beta", + "summary": "Get SEC filings for a company", + "description": "Returns a list of SEC filings (10-K, 10-Q, etc.) for the given ticker, sorted by filing date descending (newest first).", + "security": [{ "ApiKeyAuth": [] }], + "parameters": [ + { + "name": "ticker", + "in": "query", + "description": "Stock ticker symbol (case-insensitive)", + "required": true, + "schema": { "type": "string", "example": "COIN" } + } + ], + "responses": { + "200": { + "description": "Successful operation", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "filingDate": { "type": "string", "format": "date", "example": "2025-02-28" }, + "reportDate": { "type": "string", "format": "date", "example": "2024-12-31" }, + "form": { "type": "string", "example": "10-K" }, + "primaryDocumentUrl": { + "type": "string", + "format": "uri", + "example": "https://www.sec.gov/Archives/edgar/data/1679788/0001679788-25-000123/0001679788-25-000123.htm" + }, + "documentDescription": { "type": "string", "example": "Annual Report (Form 10-K)" } + } + } + } + } + } + }, + "400": { "description": "Missing required ticker parameter" }, + "401": { "description": "Unauthorized" }, + "404": { "description": "Filings not found for ticker" }, + "500": { "description": "Internal server error" } + } + } } } } diff --git a/llms.txt b/llms.txt index ccf31d03c0b..8ccd96fb6de 100644 --- a/llms.txt +++ b/llms.txt @@ -1914,3 +1914,102 @@ SECTION 12: ACCOUNT MANAGEMENT } ``` + +=============================================================================== +SECTION 13: EQUITIES (BETA) +=============================================================================== + +Stock market data for publicly traded companies. All endpoints require authentication. +Base URL: `https://pro-api.llama.fi` +Authentication: API key injected in path — `https://pro-api.llama.fi//` + +72. 🔒 **GET /equities/v1/companies** + Purpose: List all tracked public companies with current market summary + Parameters: None + Response: + ```json + [ + { + "ticker": "COIN", + "name": "Coinbase Global Inc.", + "currentPrice": 125.50, + "volume": 25000000, + "marketCap": 50000000000, + "priceChangePercentage": 2.5, + "lastUpdatedAt": "2025-03-08T12:00:00.000Z" + } + ] + ``` + +73. 🔒 **GET /equities/v1/statements?ticker={ticker}** + Purpose: Get full financial statements (income statement, balance sheet, cash flow) + Parameters: + - ticker (query, required): Stock ticker symbol e.g. COIN + Response: + ```json + { + "incomeStatement": { + "labels": ["Revenue", "Operating Expenses", "Net Income"], + "quarterly": { + "periods": ["2024-Q1", "2024-Q2"], + "periodEnding": ["2024-03-31", "2024-06-30"], + "values": [[1000000, 800000, 200000]] + }, + "annual": { + "periods": ["2023", "2024"], + "periodEnding": ["2023-12-31", "2024-12-31"], + "values": [[4000000, 3200000, 800000]] + } + }, + "balanceSheet": {}, + "cashflow": {} + } + ``` + +74. 🔒 **GET /equities/v1/price-history?ticker={ticker}** + Purpose: Get historical daily closing prices for a company + Parameters: + - ticker (query, required): Stock ticker symbol e.g. COIN + Response: + ```json + [ + { "date": "2024-12-30", "price": 124.75 }, + { "date": "2024-12-31", "price": 125.50 } + ] + ``` + +75. 🔒 **GET /equities/v1/summary?ticker={ticker}** + Purpose: Get live market summary including price, volume, market cap, 52-week range, P/E ratio + Parameters: + - ticker (query, required): Stock ticker symbol e.g. COIN + Response: + ```json + { + "currentPrice": 125.50, + "volume": 25000000, + "marketCap": 50000000000, + "fiftyTwoWeekHigh": 150.75, + "fiftyTwoWeekLow": 90.25, + "dividendYield": 0.025, + "trailingPE": 28.5, + "priceChangePercentage": 2.5, + "updatedAt": "2025-03-08T12:00:00.000Z" + } + ``` + +76. 🔒 **GET /equities/v1/filings?ticker={ticker}** + Purpose: Get SEC filings (10-K, 10-Q, etc.) sorted by filing date descending + Parameters: + - ticker (query, required): Stock ticker symbol e.g. COIN + Response: + ```json + [ + { + "filingDate": "2025-02-28", + "reportDate": "2024-12-31", + "form": "10-K", + "primaryDocumentUrl": "https://www.sec.gov/Archives/edgar/data/1679788/0001679788-25-000123/0001679788-25-000123.htm", + "documentDescription": "Annual Report (Form 10-K)" + } + ] + ``` From 3bbcb30f55024876cf49222292924fbe21d871c2 Mon Sep 17 00:00:00 2001 From: bheluga Date: Mon, 9 Mar 2026 23:11:08 +0530 Subject: [PATCH 2/2] improve wordings and examples --- defillama-openapi-pro.json | 573 ++++++++++++++++++++++++++++++++++--- llms.txt | 151 ++++++++-- 2 files changed, 653 insertions(+), 71 deletions(-) diff --git a/defillama-openapi-pro.json b/defillama-openapi-pro.json index b1e188483c8..79d7c8890e6 100644 --- a/defillama-openapi-pro.json +++ b/defillama-openapi-pro.json @@ -9087,11 +9087,10 @@ "/equities/v1/companies": { "get": { "tags": ["Equities"], - "x-scalar-tier": "pro", "x-api-plan-only": true, "x-scalar-stability": "beta", - "summary": "List all tracked public companies", - "description": "Returns a list of all publicly traded companies tracked by DefiLlama, with current market summary data for each.", + "summary": "Get list of all tracked public companies", + "description": "Returns a list of all publicly traded companies tracked by DefiLlama, with current market summary data for each, sorted by market capitalization (largest first)", "security": [{ "ApiKeyAuth": [] }], "responses": { "200": { @@ -9103,17 +9102,13 @@ "items": { "type": "object", "properties": { - "ticker": { "type": "string", "example": "COIN" }, - "name": { "type": "string", "example": "Coinbase Global Inc." }, - "currentPrice": { "type": "number", "example": 125.5 }, - "volume": { "type": "number", "example": 25000000 }, - "marketCap": { "type": "number", "example": 50000000000 }, - "priceChangePercentage": { "type": "number", "example": 2.5 }, - "lastUpdatedAt": { - "type": "string", - "format": "date-time", - "example": "2025-03-08T12:00:00.000Z" - } + "ticker": { "type": "string", "example": "NVDA" }, + "name": { "type": "string", "example": "NVIDIA Corporation" }, + "currentPrice": { "type": "number", "example": 177.88 }, + "volume": { "type": "number", "example": 189021949 }, + "marketCap": { "type": "number", "example": 4323494854656 }, + "priceChangePercentage": { "type": "number", "example": -2.94 }, + "lastUpdatedAt": { "type": "string", "example": "2026-03-09 12:12:22" } } } } @@ -9128,11 +9123,10 @@ "/equities/v1/statements": { "get": { "tags": ["Equities"], - "x-scalar-tier": "pro", "x-api-plan-only": true, "x-scalar-stability": "beta", - "summary": "Get full financial statements for a company", - "description": "Returns normalized income statement, balance sheet, and cash flow statement for the given ticker, broken down by quarterly and annual periods.", + "summary": "Get financial statements for a company", + "description": "Returns income statement, balance sheet, and cash flow statement for the given ticker, broken down by quarterly and annual periods.", "security": [{ "ApiKeyAuth": [] }], "parameters": [ { @@ -9150,43 +9144,543 @@ "application/json": { "schema": { "type": "object", + "description": "Financial statements containing income statement, balance sheet, and cash flow data broken down by quarterly and annual periods.", "properties": { "incomeStatement": { "type": "object", + "description": "Income statement data. The `labels` array defines the rows; `values` is a parallel array of arrays where each inner array holds one row's values across all periods.", "properties": { - "labels": { "type": "array", "items": { "type": "string" } }, + "labels": { + "type": "array", + "description": "Ordered list of income statement line items. Each index corresponds to an inner array in `quarterly.values` and `annual.values`.", + "items": { "type": "string" }, + "example": [ + "Total Revenue", + "Cost of Revenue", + "Gross Profit", + "Operating Expense", + "Operating Income", + "Non-operating Items", + "Income Before Tax", + "Income Tax", + "Net Income", + "Net Income to Common", + "EPS Basic", + "EPS Diluted", + "Weighted Average Shares Basic", + "Weighted Average Shares Diluted" + ] + }, + "children": { + "type": "object", + "description": "Metadata describing which top-level labels have child breakdowns and what those child labels are, separately for quarterly and annual periods.", + "properties": { + "quarterly": { + "type": "object", + "description": "Child label definitions for quarterly data. Keys are parent label names from `labels`.", + "additionalProperties": { + "type": "object", + "properties": { + "labels": { + "type": "array", + "description": "Child line item names for this parent. Each index corresponds to an inner array in `quarterly.children[label].values`.", + "items": { "type": "string" } + } + } + } + }, + "annual": { + "type": "object", + "description": "Child label definitions for annual data. Keys are parent label names from `labels`.", + "additionalProperties": { + "type": "object", + "properties": { + "labels": { + "type": "array", + "items": { "type": "string" } + } + } + } + } + } + }, "quarterly": { "type": "object", + "description": "Quarterly period data for the income statement.", "properties": { "periods": { "type": "array", + "description": "Period labels in `Q{N}-{YYYY}` format.", "items": { "type": "string" }, - "example": ["2024-Q1", "2024-Q2"] + "example": ["Q1-2024", "Q2-2024", "Q3-2024", "Q4-2024"] }, "periodEnding": { "type": "array", - "items": { "type": "string" }, - "example": ["2024-03-31", "2024-06-30"] + "description": "ISO 8601 date each quarter ended.", + "items": { "type": "string", "format": "date" }, + "example": ["2024-03-31", "2024-06-30", "2024-09-30", "2024-12-31"] }, - "values": { "type": "array", "items": { "type": "array", "items": { "type": "number" } } } + "values": { + "type": "array", + "description": "Parallel to `labels`. Each inner array contains the values for that row across all `periods`. Values may be `null` when not reported.", + "items": { + "type": "array", + "items": { "type": "number", "nullable": true } + } + }, + "children": { + "type": "object", + "description": "Breakdown data for parent labels that have sub-components. Keys match parent label names. Child labels are defined in `children.quarterly[label].labels`.", + "additionalProperties": { + "type": "object", + "properties": { + "values": { + "type": "array", + "description": "One inner array per child label, each containing values across all periods. Values may be `null`.", + "items": { + "type": "array", + "items": { "type": "number", "nullable": true } + } + } + } + } + } } }, "annual": { "type": "object", + "description": "Annual period data for the income statement.", "properties": { - "periods": { "type": "array", "items": { "type": "string" }, "example": ["2023", "2024"] }, + "periods": { + "type": "array", + "description": "Period labels in `FY-{YYYY}` format.", + "items": { "type": "string" }, + "example": ["FY-2022", "FY-2023", "FY-2024"] + }, "periodEnding": { + "type": "array", + "description": "ISO 8601 date each fiscal year ended.", + "items": { "type": "string", "format": "date" }, + "example": ["2022-12-31", "2023-12-31", "2024-12-31"] + }, + "values": { + "type": "array", + "description": "Parallel to `labels`. Each inner array contains the values for that row across all `periods`. Values may be `null`.", + "items": { + "type": "array", + "items": { "type": "number", "nullable": true } + } + }, + "children": { + "type": "object", + "description": "Breakdown data for parent labels that have sub-components. Child labels are defined in `children.annual[label].labels`.", + "additionalProperties": { + "type": "object", + "properties": { + "values": { + "type": "array", + "items": { + "type": "array", + "items": { "type": "number", "nullable": true } + } + } + } + } + } + } + } + } + }, + "balanceSheet": { + "type": "object", + "description": "Balance sheet data. Follows the same structure as `incomeStatement`: top-level `labels`, `children` metadata, and `quarterly`/`annual` period objects each containing `periods`, `periodEnding`, `values`, and `children`.", + "properties": { + "labels": { + "type": "array", + "description": "Ordered list of balance sheet line items.", + "items": { "type": "string" }, + "example": [ + "Total Current Assets", + "Total Non-Current Assets", + "Total Assets", + "Total Current Liabilities", + "Total Non-Current Liabilities", + "Total Liabilities", + "Total Mezzanine Equity", + "Total Stockholders Equity", + "Total Equity", + "Total Liabilities and Equity" + ] + }, + "children": { + "type": "object", + "properties": { + "quarterly": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "labels": { "type": "array", "items": { "type": "string" } } + } + } + }, + "annual": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "labels": { "type": "array", "items": { "type": "string" } } + } + } + } + } + }, + "quarterly": { + "type": "object", + "properties": { + "periods": { + "type": "array", + "items": { "type": "string" }, + "example": ["Q1-2024", "Q2-2024"] + }, + "periodEnding": { "type": "array", "items": { "type": "string", "format": "date" } }, + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } + }, + "children": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } + } + } + } + } + } + }, + "annual": { + "type": "object", + "properties": { + "periods": { "type": "array", "items": { "type": "string" }, - "example": ["2023-12-31", "2024-12-31"] + "example": ["FY-2023", "FY-2024"] + }, + "periodEnding": { "type": "array", "items": { "type": "string", "format": "date" } }, + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } }, - "values": { "type": "array", "items": { "type": "array", "items": { "type": "number" } } } + "children": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } + } + } + } + } } } } }, - "balanceSheet": { "type": "object" }, - "cashflow": { "type": "object" } + "cashflow": { + "type": "object", + "description": "Cash flow statement data. Follows the same structure as `incomeStatement`: top-level `labels`, `children` metadata, and `quarterly`/`annual` period objects each containing `periods`, `periodEnding`, `values`, and `children`.", + "properties": { + "labels": { + "type": "array", + "description": "Ordered list of cash flow line items.", + "items": { "type": "string" }, + "example": [ + "Cashflow From Operating Activities", + "Cashflow From Investing Activities", + "Cashflow From Financing Activities", + "Effect of Exchange Rate Changes on Cash", + "Net Cashflow" + ] + }, + "children": { + "type": "object", + "properties": { + "quarterly": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "labels": { "type": "array", "items": { "type": "string" } } + } + } + }, + "annual": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "labels": { "type": "array", "items": { "type": "string" } } + } + } + } + } + }, + "quarterly": { + "type": "object", + "properties": { + "periods": { + "type": "array", + "items": { "type": "string" }, + "example": ["Q1-2024", "Q2-2024"] + }, + "periodEnding": { "type": "array", "items": { "type": "string", "format": "date" } }, + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } + }, + "children": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } + } + } + } + } + } + }, + "annual": { + "type": "object", + "properties": { + "periods": { + "type": "array", + "items": { "type": "string" }, + "example": ["FY-2023", "FY-2024"] + }, + "periodEnding": { "type": "array", "items": { "type": "string", "format": "date" } }, + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } + }, + "children": { + "type": "object", + "additionalProperties": { + "type": "object", + "properties": { + "values": { + "type": "array", + "items": { "type": "array", "items": { "type": "number", "nullable": true } } + } + } + } + } + } + } + } + } + } + }, + "example": { + "incomeStatement": { + "labels": [ + "Total Revenue", + "Cost of Revenue", + "Gross Profit", + "Operating Expense", + "Operating Income", + "Non-operating Items", + "Income Before Tax", + "Net Income" + ], + "children": { + "quarterly": { + "Total Revenue": { + "labels": ["Bank Servicing and Subscription and Circulation", "Remaining Items"] + }, + "Operating Expense": { + "labels": [ + "General and Administrative Expense", + "Research and Development Expense", + "Selling and Marketing Expense", + "Other Operating Income (Expense), Net", + "Remaining Items" + ] + }, + "Non-operating Items": { + "labels": ["Other Nonoperating Income (Expense)", "Remaining Items"] + } + }, + "annual": { + "Total Revenue": { + "labels": ["Bank Servicing and Subscription and Circulation", "Remaining Items"] + }, + "Operating Expense": { + "labels": [ + "General and Administrative Expense", + "Research and Development Expense", + "Selling and Marketing Expense", + "Other Operating Income (Expense), Net", + "Remaining Items" + ] + }, + "Non-operating Items": { + "labels": ["Other Nonoperating Income (Expense)", "Remaining Items"] + } + } + }, + "quarterly": { + "periods": ["Q1-2024", "Q2-2024", "Q3-2024", "Q4-2024"], + "periodEnding": ["2024-03-31", "2024-06-30", "2024-09-30", "2024-12-31"], + "values": [ + [1801112000, 2227962000, 1311908000, 2498462000], + [234066000, 335426000, 197251000, 501181000], + [1567046000, 1892536000, 1114657000, 1997281000], + [579333000, 1017811000, 822849000, null], + [987713000, 874725000, 291808000, 922324000], + [8953000, -5844000, -20948000, -31784000], + [996666000, 868881000, 270860000, 890540000], + [771463000, 1606349000, 406100000, 840208000] + ], + "children": { + "Total Revenue": { + "values": [ + [1596981000, 2033011000, 1234736000, 2490025000], + [204131000, 194951000, 77172000, 8437000] + ] + }, + "Operating Expense": { + "values": [ + [121231000, 248195000, 242642000, 297324000], + [184225000, 291461000, 356264000, 459611000], + [117990000, 195733000, 105395000, 244571000], + [null, 282422000, 118548000, 258627000], + [155887000, 73451000, 144489000, -1035000] + ] + }, + "Non-operating Items": { + "values": [ + [8953000, -5844000, -20948000, -31784000], + [987713000, 868881000, 270860000, 890540000] + ] + } + } + }, + "annual": { + "periods": ["FY-2023", "FY-2024"], + "periodEnding": ["2023-12-31", "2024-12-31"], + "values": [ + [1166436000, 2271637000], + [277826000, 317042000], + [888610000, 1954595000], + [1443073000, 920526000], + [-554463000, 1034069000], + [-54982000, 462807000], + [-609445000, 1496876000], + [-429659000, 1291176000] + ], + "children": { + "Total Revenue": { + "values": [[1164891000, 2197030000], [1545000, 74607000]] + }, + "Operating Expense": { + "values": [ + [413578000, 362519000], + [570664000, 368691000], + [200204000, 225827000], + [258627000, -20270000], + [42453000, -16241000] + ] + }, + "Non-operating Items": { + "values": [[-54982000, 462807000], [-609445000, 1496876000]] + } + } + } + }, + "balanceSheet": { + "labels": [ + "Total Current Assets", + "Total Non-Current Assets", + "Total Assets", + "Total Current Liabilities", + "Total Liabilities", + "Total Stockholders Equity", + "Total Liabilities and Equity" + ], + "children": { + "quarterly": {}, + "annual": {} + }, + "quarterly": { + "periods": ["Q1-2024", "Q2-2024", "Q3-2024", "Q4-2024"], + "periodEnding": ["2024-03-31", "2024-06-30", "2024-09-30", "2024-12-31"], + "values": [ + [79373000, 204728000, 209604000, 215571000], + [126996000, 248147000, 250536000, 254181000], + [206369000, 452875000, 460140000, 469752000], + [217472000, 221034000, 223916000, 226930000], + [217472000, 221034000, 223916000, 226930000], + [231489000, 234641000, 237270000, 314164000], + [448961000, 455675000, 457186000, 541094000] + ], + "children": {} + }, + "annual": { + "periods": ["FY-2023", "FY-2024"], + "periodEnding": ["2023-12-31", "2024-12-31"], + "values": [ + [217472000, 226930000], + [217472000, 226930000], + [434944000, 453860000], + [221034000, 226930000], + [221034000, 226930000], + [234641000, 314164000], + [455675000, 541094000] + ], + "children": {} + } + }, + "cashflow": { + "labels": [ + "Cashflow From Operating Activities", + "Cashflow From Investing Activities", + "Cashflow From Financing Activities", + "Net Cashflow" + ], + "children": { + "quarterly": {}, + "annual": {} + }, + "quarterly": { + "periods": ["Q1-2024", "Q2-2024", "Q3-2024", "Q4-2024"], + "periodEnding": ["2024-03-31", "2024-06-30", "2024-09-30", "2024-12-31"], + "values": [ + [234066000, 335426000, 197251000, 501181000], + [-121231000, -248195000, -242642000, -297324000], + [-98771300, -87472500, -29180800, -92232400], + [14221670, 13119700, -7440700, 111211600] + ], + "children": {} + }, + "annual": { + "periods": ["FY-2023", "FY-2024"], + "periodEnding": ["2023-12-31", "2024-12-31"], + "values": [ + [277826000, 317042000], + [-413578000, -362519000], + [-55446300, 103406900], + [-19123600, 45811400] + ], + "children": {} + } } } } @@ -9202,11 +9696,10 @@ "/equities/v1/price-history": { "get": { "tags": ["Equities"], - "x-scalar-tier": "pro", "x-api-plan-only": true, "x-scalar-stability": "beta", "summary": "Get historical price data for a company", - "description": "Returns an array of daily closing prices for the given ticker, sorted from oldest to newest.", + "description": "Returns an array of daily closing prices for the given ticker, sorted by date descending (newest first)", "security": [{ "ApiKeyAuth": [] }], "parameters": [ { @@ -9245,7 +9738,6 @@ "/equities/v1/summary": { "get": { "tags": ["Equities"], - "x-scalar-tier": "pro", "x-api-plan-only": true, "x-scalar-stability": "beta", "summary": "Get live market summary for a company", @@ -9268,15 +9760,15 @@ "schema": { "type": "object", "properties": { - "currentPrice": { "type": "number", "example": 125.5 }, - "volume": { "type": "number", "example": 25000000 }, - "marketCap": { "type": "number", "example": 50000000000 }, - "fiftyTwoWeekHigh": { "type": "number", "example": 150.75 }, - "fiftyTwoWeekLow": { "type": "number", "example": 90.25 }, - "dividendYield": { "type": "number", "example": 0.025 }, - "trailingPE": { "type": "number", "example": 28.5 }, - "priceChangePercentage": { "type": "number", "example": 2.5 }, - "updatedAt": { "type": "string", "format": "date-time", "example": "2025-03-08T12:00:00.000Z" } + "currentPrice": { "type": "number", "example": 250.13 }, + "volume": { "type": "number", "example": 1841923 }, + "marketCap": { "type": "number", "example": 100677328896 }, + "fiftyTwoWeekHigh": { "type": "number", "example": 267.31 }, + "fiftyTwoWeekLow": { "type": "number", "example": 105.04 }, + "dividendYield": { "type": "number", "nullable": true, "example": 0.1743 }, + "trailingPE": { "type": "number", "nullable": true, "example": 67.6 }, + "priceChangePercentage": { "type": "number", "example": -0.9 }, + "updatedAt": { "type": "string", "example": "2026-03-09 12:12:22" } } } } @@ -9292,7 +9784,6 @@ "/equities/v1/filings": { "get": { "tags": ["Equities"], - "x-scalar-tier": "pro", "x-api-plan-only": true, "x-scalar-stability": "beta", "summary": "Get SEC filings for a company", @@ -9325,7 +9816,7 @@ "format": "uri", "example": "https://www.sec.gov/Archives/edgar/data/1679788/0001679788-25-000123/0001679788-25-000123.htm" }, - "documentDescription": { "type": "string", "example": "Annual Report (Form 10-K)" } + "documentDescription": { "type": "string", "example": "Annual Report" } } } } diff --git a/llms.txt b/llms.txt index 8ccd96fb6de..361ee18e4b6 100644 --- a/llms.txt +++ b/llms.txt @@ -1924,57 +1924,148 @@ Base URL: `https://pro-api.llama.fi` Authentication: API key injected in path — `https://pro-api.llama.fi//` 72. 🔒 **GET /equities/v1/companies** - Purpose: List all tracked public companies with current market summary + Purpose: Get list of all tracked public companies with current market summary, sorted by market cap (largest first) Parameters: None Response: ```json [ { - "ticker": "COIN", - "name": "Coinbase Global Inc.", - "currentPrice": 125.50, - "volume": 25000000, - "marketCap": 50000000000, - "priceChangePercentage": 2.5, - "lastUpdatedAt": "2025-03-08T12:00:00.000Z" + "ticker": "NVDA", + "name": "NVIDIA Corporation", + "currentPrice": 177.88, + "volume": 189021949, + "marketCap": 4323494854656, + "priceChangePercentage": -2.94, + "lastUpdatedAt": "2026-03-09 12:12:22" } ] ``` 73. 🔒 **GET /equities/v1/statements?ticker={ticker}** - Purpose: Get full financial statements (income statement, balance sheet, cash flow) + Purpose: Get financial statements (income statement, balance sheet, cash flow) Parameters: - ticker (query, required): Stock ticker symbol e.g. COIN + Note: Each statement has top-level `labels` (row names), `children` metadata for sub-breakdowns, and `quarterly`/`annual` objects each containing `periods` (e.g. "Q1-2024" / "FY-2024"), `periodEnding` (ISO dates), `values` (parallel array of arrays), and `children` (breakdown values). Response: ```json { "incomeStatement": { - "labels": ["Revenue", "Operating Expenses", "Net Income"], + "labels": ["Total Revenue", "Cost of Revenue", "Gross Profit", "Operating Expense", "Operating Income", "Non-operating Items", "Income Before Tax", "Net Income"], + "children": { + "quarterly": { + "Total Revenue": { "labels": ["Bank Servicing and Subscription and Circulation", "Remaining Items"] }, + "Operating Expense": { "labels": ["General and Administrative Expense", "Research and Development Expense", "Selling and Marketing Expense", "Other Operating Income (Expense), Net", "Remaining Items"] }, + "Non-operating Items": { "labels": ["Other Nonoperating Income (Expense)", "Remaining Items"] } + }, + "annual": { + "Total Revenue": { "labels": ["Bank Servicing and Subscription and Circulation", "Remaining Items"] }, + "Operating Expense": { "labels": ["General and Administrative Expense", "Research and Development Expense", "Selling and Marketing Expense", "Other Operating Income (Expense), Net", "Remaining Items"] }, + "Non-operating Items": { "labels": ["Other Nonoperating Income (Expense)", "Remaining Items"] } + } + }, "quarterly": { - "periods": ["2024-Q1", "2024-Q2"], - "periodEnding": ["2024-03-31", "2024-06-30"], - "values": [[1000000, 800000, 200000]] + "periods": ["Q1-2024", "Q2-2024", "Q3-2024", "Q4-2024"], + "periodEnding": ["2024-03-31", "2024-06-30", "2024-09-30", "2024-12-31"], + "values": [ + [1801112000, 2227962000, 1311908000, 2498462000], + [234066000, 335426000, 197251000, 501181000], + [1567046000, 1892536000, 1114657000, 1997281000], + [579333000, 1017811000, 822849000, null], + [987713000, 874725000, 291808000, 922324000], + [8953000, -5844000, -20948000, -31784000], + [996666000, 868881000, 270860000, 890540000], + [771463000, 1606349000, 406100000, 840208000] + ], + "children": { + "Total Revenue": { + "values": [[1596981000, 2033011000, 1234736000, 2490025000], [204131000, 194951000, 77172000, 8437000]] + }, + "Operating Expense": { + "values": [ + [121231000, 248195000, 242642000, 297324000], + [184225000, 291461000, 356264000, 459611000], + [117990000, 195733000, 105395000, 244571000], + [null, 282422000, 118548000, 258627000], + [155887000, 73451000, 144489000, -1035000] + ] + }, + "Non-operating Items": { + "values": [[8953000, -5844000, -20948000, -31784000], [987713000, 868881000, 270860000, 890540000]] + } + } }, "annual": { - "periods": ["2023", "2024"], + "periods": ["FY-2023", "FY-2024"], "periodEnding": ["2023-12-31", "2024-12-31"], - "values": [[4000000, 3200000, 800000]] + "values": [ + [1166436000, 2271637000], + [277826000, 317042000], + [888610000, 1954595000], + [1443073000, 920526000], + [-554463000, 1034069000], + [-54982000, 462807000], + [-609445000, 1496876000], + [-429659000, 1291176000] + ], + "children": { + "Total Revenue": { "values": [[1164891000, 2197030000], [1545000, 74607000]] }, + "Operating Expense": { + "values": [ + [413578000, 362519000], + [570664000, 368691000], + [200204000, 225827000], + [258627000, -20270000], + [42453000, -16241000] + ] + }, + "Non-operating Items": { "values": [[-54982000, 462807000], [-609445000, 1496876000]] } + } } }, - "balanceSheet": {}, - "cashflow": {} + "balanceSheet": { + "labels": ["Total Current Assets", "Total Non-Current Assets", "Total Assets", "Total Current Liabilities", "Total Liabilities", "Total Stockholders Equity", "Total Liabilities and Equity"], + "children": { "quarterly": {}, "annual": {} }, + "quarterly": { + "periods": ["Q1-2024", "Q2-2024", "Q3-2024", "Q4-2024"], + "periodEnding": ["2024-03-31", "2024-06-30", "2024-09-30", "2024-12-31"], + "values": [[79373000, 204728000, 209604000, 215571000], [126996000, 248147000, 250536000, 254181000], [206369000, 452875000, 460140000, 469752000], [217472000, 221034000, 223916000, 226930000], [217472000, 221034000, 223916000, 226930000], [231489000, 234641000, 237270000, 314164000], [448961000, 455675000, 457186000, 541094000]], + "children": {} + }, + "annual": { + "periods": ["FY-2023", "FY-2024"], + "periodEnding": ["2023-12-31", "2024-12-31"], + "values": [[217472000, 226930000], [217472000, 226930000], [434944000, 453860000], [221034000, 226930000], [221034000, 226930000], [234641000, 314164000], [455675000, 541094000]], + "children": {} + } + }, + "cashflow": { + "labels": ["Cashflow From Operating Activities", "Cashflow From Investing Activities", "Cashflow From Financing Activities", "Net Cashflow"], + "children": { "quarterly": {}, "annual": {} }, + "quarterly": { + "periods": ["Q1-2024", "Q2-2024", "Q3-2024", "Q4-2024"], + "periodEnding": ["2024-03-31", "2024-06-30", "2024-09-30", "2024-12-31"], + "values": [[234066000, 335426000, 197251000, 501181000], [-121231000, -248195000, -242642000, -297324000], [-98771300, -87472500, -29180800, -92232400], [14221670, 13119700, -7440700, 111211600]], + "children": {} + }, + "annual": { + "periods": ["FY-2023", "FY-2024"], + "periodEnding": ["2023-12-31", "2024-12-31"], + "values": [[277826000, 317042000], [-413578000, -362519000], [-55446300, 103406900], [-19123600, 45811400]], + "children": {} + } + } } ``` 74. 🔒 **GET /equities/v1/price-history?ticker={ticker}** - Purpose: Get historical daily closing prices for a company + Purpose: Returns an array of daily closing prices for the given ticker, sorted by date descending (newest first) Parameters: - ticker (query, required): Stock ticker symbol e.g. COIN Response: ```json [ - { "date": "2024-12-30", "price": 124.75 }, - { "date": "2024-12-31", "price": 125.50 } + { "date": "2024-12-31", "price": 125.50 }, + { "date": "2024-12-30", "price": 124.75 } ] ``` @@ -1985,15 +2076,15 @@ Authentication: API key injected in path — `https://pro-api.llama.fi/