# AIsa Earnings Data API > AIsa Earnings Data API is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.02/call, status unknown (last checked 2026-10-14). Returns the most recent earnings snapshots (income statement, balance sheet, cash flow, and margins) for a given stock ticker symbol. ## Facts - Endpoint: GET https://api.aisa.one/apis/v1/financial/earnings?utm_source=zero.xyz - Price: $0.02/call - Payment: MPP - Status: unknown - Last checked: 2026-10-14 - Activations on Zero: 0 - Provider: AIsa MPP Data APIs - Website: https://aisa.one - Tags: web-search, financial-data, prediction-markets, weather, travel, data, search - Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-aisa-earnings-data-api-92f62f1d - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0PbqmOtcvJ52GEAEQYHHA Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability aisa-mpp-data-apis-aisa-earnings-data-api-92f62f1d ``` Example prompt: Pull the two most recent earnings snapshots for NVDA — I want to see revenue, net income, EPS, free cash flow, and margins for each period. ## When to prefer this Use this endpoint when you need structured, machine-readable earnings data (income statement, margins, cash flow, balance sheet highlights) for a public US equity ticker, especially when you need period-over-period change metrics or multiple consecutive quarters. Prefer this over web search for reliable, schema-consistent financial data with pagination support for trend analysis. ## Known failure modes - Invalid or unrecognized ticker returns 400 or empty earnings array - Non-positive or non-integer limit value returns 400 - Change fields (revenue_chg, net_income_chg, etc.) are omitted when prior-period data is unavailable for comparison - Some financial fields may be null if not reported or not parsed from the filing - Pagination cursor becomes invalid if reused incorrectly or after data refresh ## How this service works Get the most recent earnings snapshot for a ticker. Optional change fields are returned only when available. Published reference price: $0.02 USD per successful request. Account-specific pricing and final settlement may differ. ## Output An array of earnings objects per report period, each containing income statement metrics (revenue, gross profit, operating income, net income, EPS), balance sheet figures (total assets, total liabilities, total debt), cash flow (free cash flow), and computed margins and period-over-period change percentages. Pagination is handled via next_page_url cursors. Up to 10 records per page, up to 40 report periods total. ## Request schema (JSON Schema) ```json { "type": "object", "required": [ "ticker" ], "properties": { "limit": { "type": "integer", "default": 1, "maximum": 40, "minimum": 1, "description": "Number of most-recent **report periods** worth of filings to return, sorted by `(report_period DESC, filing_date ASC)`. The number of entries returned may exceed `limit` when a recent period has both an 8-K and a 10-Q / 10-K. Values above 40 are clamped to 40. Non-positive or non-integer values return 400. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`." }, "cursor": { "type": "string", "description": "Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it." }, "ticker": { "type": "string", "description": "The ticker symbol (e.g. `AAPL`)." } } } ``` ## Response schema (JSON Schema) ```json { "type": "object", "properties": { "earnings": { "type": "array", "items": { "type": "object", "required": [ "ticker", "report_period", "source_type", "filing_date", "filing_url", "accession_number" ], "properties": { "annual": { "type": "object", "properties": { "revenue": { "type": [ "number", "null" ] }, "net_income": { "type": [ "number", "null" ] }, "net_margin": { "type": "number", "description": "Net margin as a decimal (net_income / revenue). Returned only when calculable." }, "total_debt": { "type": [ "number", "null" ] }, "revenue_chg": { "type": "number", "description": "Percentage change in revenue versus the prior period as a decimal (e.g. 0.10 = +10%). Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "gross_margin": { "type": "number", "description": "Gross margin as a decimal (gross_profit / revenue). Returned only when calculable." }, "gross_profit": { "type": [ "number", "null" ] }, "total_assets": { "type": [ "number", "null" ] }, "free_cash_flow": { "type": [ "number", "null" ] }, "net_income_chg": { "type": "number", "description": "Percentage change in net income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "revenue_yoy_chg": { "type": "number", "description": "Year-over-year change in revenue versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable." }, "gross_profit_chg": { "type": "number", "description": "Percentage change in gross profit versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable." }, "operating_income": { "type": [ "number", "null" ] }, "operating_margin": { "type": "number", "description": "Operating margin as a … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-aisa-earnings-data-api-92f62f1d/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)