{"uid":"cap_j8KKiPBzq5Nlki-E-Re6R","slug":"heurist-mesh-sec-xbrl-fact-trends-60f8acde","name":"Heurist Mesh: SEC XBRL Fact Trends","description":"Return quarterly or annual SEC XBRL fact observations for one metric and one issuer. Accepts plain-English metric names or exact XBRL concept names. See the metric parameter for supported values.","url":"https://mesh.heurist.xyz/x402/solana/agents/SecEdgarAgent/xbrl_fact_trends","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["query","metric"],"properties":{"unit":{"type":"string","description":"Optional exact SEC unit key for the selected concept. Common examples include 'USD', 'shares', 'USD/shares', and 'pure', but available units depend on the matched metric. Omit to auto-select the unit with the most observations."},"debug":{"type":"boolean","default":false,"description":"Debug mode flag. ALWAYS use false."},"limit":{"type":"integer","default":8,"description":"Maximum number of observations to return."},"query":{"type":"string","description":"Company name, ticker, or CIK."},"metric":{"type":"string","description":"Plain-English metric name (e.g. 'revenue', 'net income', 'eps', 'cash', 'assets') or exact XBRL concept name (e.g. 'NetIncomeLoss'). One metric per call."},"taxonomy":{"enum":["us-gaap","dei"],"type":"string","description":"Optional taxonomy filter."},"frequency":{"enum":["quarterly","annual","all"],"type":"string","default":"quarterly","description":"Observation frequency filter."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"result":{"type":"object","additionalProperties":true}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jmUhvocaYFpBVHAFBI8e-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns quarterly or annual SEC XBRL financial fact observations for a specific metric and issuer, supporting plain-English or exact XBRL concept names.","exampleAgentPrompt":"Pull the quarterly revenue trend for Apple from SEC EDGAR XBRL filings — I want to see how it's changed over recent periods.","exampleUseCases":[{"title":"Quarterly earnings trend analysis","prompt":"Get me Microsoft's quarterly net income observations from SEC XBRL filings so I can see how their earnings have trended over the last few years."},{"title":"Annual R&D spending history","prompt":"Pull the annual research and development expense data for Amazon from SEC EDGAR XBRL — I want to track how much they've been investing in R&D year over year."},{"title":"EPS history for equity research","prompt":"Retrieve the quarterly earnings per share XBRL facts for NVIDIA from SEC filings so I can build out their historical EPS trend."}],"resultDescription":"Returns a structured list of XBRL fact observations for the requested metric and issuer, including reported values, fiscal period labels (e.g. Q1 2023, FY2022), filing dates, and units of measurement, sourced directly from SEC EDGAR XBRL data.","failureModes":["Unknown or unsupported metric name returns an error or empty result","Company not found if ticker or name is ambiguous or not a public SEC filer","No data available for very recent periods not yet filed with SEC","XBRL concept name typo results in no matching observations","Rate limiting or payment failure if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need structured, audited financial fact data directly from SEC EDGAR XBRL filings for US public companies. Prefer this over third-party financial data APIs when regulatory accuracy and traceability to official filings matter, or when you need to support both plain-English metric names and precise XBRL concept names. Not suited for real-time price data or non-US issuers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:50:13.115Z","isFirstParty":false}