{"uid":"cap_TXj-egvkGqgm70GGi9ZDr","slug":"ysaere-sec-retained-earnings-lookup-e2ad62bf","name":"Ysaere SEC Retained Earnings Lookup","description":"Ysaere Agent Retained Earnings — $0.02 USDC, no account needed. Input: {\"target\":\"COST\"}. The answer is in this response. A missing answer is refused before payment. Wallet only. No account price.","url":"https://api.ysaere.com/v1/intel/sec-retained-earnings?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"target":{"type":"string","description":"Company name or ticker (for example \"COST\")"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jwQIde_ihrhjTczlfGM_U","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves retained earnings data from SEC filings for a given public company by name or ticker symbol","exampleAgentPrompt":"What are the retained earnings for Costco according to their SEC filings? Look up the ticker COST.","exampleUseCases":[{"title":"Equity analysis for investment research","prompt":"Pull the retained earnings figure for NVIDIA from their SEC filings — I'm building a balance sheet summary for my investment report."},{"title":"Automated financial data pipeline","prompt":"Get me the retained earnings for Microsoft (MSFT) from SEC data so I can update our financial model with the latest balance sheet figures."},{"title":"Comparing retained earnings across competitors","prompt":"What are the retained earnings for Amazon according to their SEC filings? I want to compare it to other major retailers on their balance sheets."}],"resultDescription":"Returns the retained earnings value for the specified public company as reported in their SEC filings, typically sourced from the balance sheet section of annual or quarterly reports. The response contains the numeric financial figure along with relevant context.","failureModes":["Unknown or invalid ticker/company name returns an error or refusal before payment is processed","Company not found in SEC database (e.g. private companies, foreign-only filers) results in no data","Payment not completed results in no answer being returned","Ambiguous company name may require a more specific ticker","SEC data may be delayed or reflect last filed period rather than real-time"],"whenToPreferThis":"Use this endpoint when you need retained earnings specifically from SEC filings for a US-listed public company, without requiring an account or subscription. Ideal for lightweight, pay-per-query financial data retrieval at $0.02 USDC per call. Prefer this over full financial data APIs when you only need a single financial metric and want minimal setup overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T00:40:19.060Z","isFirstParty":false,"canonicalSlug":"ysaere-sec-retained-earnings-lookup-e2ad62bf"}