{"uid":"cap_xMKOw19SxDV92hIIX2-S_","slug":"sec-edgar-xbrl-concept-time-series-e7d70a01","name":"SEC EDGAR XBRL Concept Time-Series","description":"Cited time-series for a single financial line-item from SEC EDGAR XBRL. Give a ticker or CIK plus a concept (a canonical name like revenue or netIncome, or a raw us-gaap tag) and get the normalized period values, each cited to its filing. Cheap granular pull.","url":"https://payai.agentstools.dev/edgar/concept","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["concept"],"properties":{"cik":{"type":"string","description":"SEC EDGAR CIK, any zero-padding accepted"},"freq":{"enum":["annual","quarterly"],"type":"string","description":"Reporting frequency, default annual"},"ticker":{"type":"string","description":"Stock ticker symbol, e.g. AAPL"},"concept":{"type":"string","description":"Canonical line name like revenue, or a raw us-gaap tag"},"periods":{"type":"integer","maximum":12,"minimum":1,"description":"Number of recent periods to return, default 8"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UGLuxpj9cE9TxZLWY_dSB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves cited time-series data for a single financial line-item (e.g. revenue, net income) from SEC EDGAR XBRL filings, normalized by period and linked to source filings.","exampleAgentPrompt":"Pull the last 8 annual revenue figures for Apple (ticker AAPL) from SEC EDGAR XBRL filings — I need each value cited to its actual filing.","exampleUseCases":[{"title":"Track competitor gross margin trends","prompt":"Grab the last 12 quarterly gross profit figures for Microsoft from their SEC filings so I can compare their margin trajectory against our projections."},{"title":"Verify earnings claim for due diligence","prompt":"Pull Tesla's net income history from EDGAR for the past 5 years, with each value linked to the filing it came from — I need to verify some investor claims we're hearing."},{"title":"Build financial health dashboard","prompt":"Fetch quarterly operating income data for the S&P 500 companies in our portfolio from their SEC filings — I want to track which ones are trending up or down this year."}],"resultDescription":"A time-series array of normalized period values for the requested financial concept, each entry tagged with the filing it came from, covering up to 12 recent annual or quarterly periods.","failureModes":["Unknown ticker or CIK returns 404 or empty result","Unrecognized concept name returns error or no data","Requesting more than 12 periods returns validation error","Company has not filed XBRL data for requested periods","us-gaap tag not present in filings returns empty array","Payment failure or insufficient USDC balance blocks request"],"whenToPreferThis":"Use this endpoint when you need granular, filing-cited time-series for a specific financial line-item from SEC EDGAR — ideal for financial analysis, trend detection, or compliance work where provenance to the original filing matters. Prefer over full-document scraping when you only need one concept across multiple periods.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:11:14.623Z","isFirstParty":false}