{"uid":"cap_iU48wgxOWkAJzbgmFXdQ_","slug":"sec-edgar-xbrl-concept-time-series-6ebe475a","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://api.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_vZf0oQxHxNxdHnDU1QgL_","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":"Returns a cited time-series of values for a single financial line-item (e.g. revenue, net income) from SEC EDGAR XBRL filings, for a given company and concept.","exampleAgentPrompt":"Pull the last 8 annual revenue figures for Apple (ticker AAPL) from SEC EDGAR XBRL filings, each cited to its source filing.","exampleUseCases":[{"title":"Track quarterly earnings trend for investor","prompt":"Get me Tesla's net income for the last 6 quarters from SEC filings, so I can see if they're trending up or down."},{"title":"Compare historical gross profit across years","prompt":"Fetch Amazon's gross profit values going back 10 years from EDGAR XBRL, with citations so I know exactly which filing each number comes from."},{"title":"Monitor operating income for due diligence","prompt":"Pull Nvidia's operating income from their last 8 quarterly and annual SEC filings, normalized and cited to the source documents."}],"resultDescription":"A time-series array of normalized period values for the requested financial concept, each entry annotated with its source SEC filing citation (accession number, form type, period of report), 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","Company has no XBRL filings (e.g. foreign private issuers) returns empty","Requesting more than 12 periods returns validation error","Missing required concept parameter returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need a clean, cited time-series for a specific financial line-item (e.g. revenue, net income, EPS) for a single company directly from SEC EDGAR XBRL data, especially when you need filing-level citations and normalized values. Prefer over full financial statement endpoints when you only need one concept. Better than scraping investor relations pages or using aggregator APIs when SEC-cited provenance is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:51:30.698Z","isFirstParty":false}