{"uid":"cap_geqpOlMqpIIUluE12NlsQ","slug":"deepsearch-us-earnings-summary-api-15ae6a3e","name":"DeepSearch US Earnings Summary API","description":"Up to 10 years of financials + 3 years of daily price history for all 2,000+ KRX stocks. Pay-per-query with USDC on Base Mainnet — no subscription.","url":"https://x402.deepsearch.com/v1/context/us/earnings/%7Bticker%7D/summary","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["ticker"],"properties":{"period":{"type":"string","description":"Optional YYYY-QN (e.g. 2026-Q2). Omit for latest."},"ticker":{"type":"string","description":"US symbol, e.g. AAPL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"period":"2026-Q2","ticker":"AAPL","summary":"애플은 재무실적 발표에서 2026년 회계연도 2분기 실적을 보고하였으며..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gSiNVffAhrfXXlG5J5q7P","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a natural-language earnings summary for a given US stock ticker and optional fiscal quarter, powered by up to 10 years of financial data.","exampleAgentPrompt":"Can you pull up the DeepSearch earnings summary for AAPL for Q2 2026 — I want a quick digest of how Apple performed that quarter?","exampleUseCases":[{"title":"Quarterly earnings digest for investor","prompt":"Give me a summary of NVDA's earnings for Q1 2025 — I want to know how Nvidia performed that quarter in plain language."},{"title":"Analyst pre-meeting briefing","prompt":"Before my call this afternoon, can you grab the latest earnings summary for MSFT so I have a quick overview of Microsoft's most recent quarterly results?"},{"title":"Automated portfolio monitoring agent","prompt":"For each of the tickers in my watchlist — AAPL, TSLA, and AMZN — pull the most recent quarterly earnings summary from DeepSearch so I can compare how they did."}],"resultDescription":"Returns a JSON object with the ticker symbol, fiscal period (e.g. '2026-Q2'), and a natural-language summary of the company's earnings results for that quarter, written in Korean based on the example response.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Requested period not yet available returns no data","Non-US ticker passed to US endpoint may return no result","Network or payment authorization failure via x402 protocol returns 402 status","Malformed period string (not YYYY-QN format) may cause a bad request error"],"whenToPreferThis":"Choose this endpoint when you need a fast, readable natural-language digest of US company earnings for a specific quarter, especially if you want pre-processed summaries rather than raw financial tables. Prefer it over raw financial data endpoints when the goal is to quickly understand business performance without parsing structured financials yourself. Best suited for single-ticker, per-quarter lookups with pay-per-query pricing via USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:41:37.518Z","isFirstParty":false}