{"uid":"cap_ZE7u4uYKAkhRR6NgrRU0t","slug":"x402stock-sec-edgar-concept-data-api-7c33f2f5","name":"x402stock SEC EDGAR Concept Data API","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/concept/%7Bticker%7D","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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["taxonomy","limit"],"properties":{"tag":{"type":"string"},"limit":{"type":"integer","default":8,"maximum":100,"exclusiveMinimum":0},"taxonomy":{"type":"string","default":"us-gaap"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["tag","taxonomy","label","unit","count","series"],"properties":{"tag":{"type":"string"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"count":{"type":"number"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"series":{"type":"array","items":{"type":"object","required":["value","start","end","fiscal_year","fiscal_period","form","filed","frame","accession"],"properties":{"end":{"type":"string"},"form":{"type":"string"},"filed":{"type":"string"},"frame":{"anyOf":[{"type":"string"},{"type":"null"}]},"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"type":"number"},"accession":{"type":"string"},"fiscal_year":{"anyOf":[{"type":"number"},{"type":"null"}]},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"taxonomy":{"type":"string"}},"additionalProperties":false},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","const":"sec_edgar"},"ticker":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":{"tag":"RevenueFromContractWithCustomerExcludingAssessedTax","unit":"USD","count":1,"label":"Revenue from Contract with Customer, Excluding Assessed Tax","series":[{"end":"2026-03-28","form":"10-Q","filed":"2026-05-01","frame":"CY2026Q1","start":"2025-12-28","value":111184000000,"accession":"0000320193-26-000013","fiscal_year":2026,"fiscal_period":"Q2"}],"taxonomy":"us-gaap"},"as_of":"2026-05-01T00:00:00.000Z","source":"sec_edgar","ticker":"AAPL"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_0V7QwT6O1teSWtnsuDpqV","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 historical SEC EDGAR financial concept (XBRL taxonomy tag) time-series data for a given stock ticker, such as revenue or earnings reported in 10-K/10-Q filings.","exampleAgentPrompt":"Pull the historical revenue series for AAPL from SEC EDGAR using the us-gaap taxonomy, limiting to the 8 most recent periods — I want to see what Apple reported each quarter.","exampleUseCases":[{"title":"Audit net income history from filings","prompt":"Pull the full net income time series for Tesla from SEC EDGAR filings — I want to see exactly what they reported each quarter and fiscal year going back as far as possible, straight from their 10-K and 10-Q submissions."},{"title":"Compare EPS trends across fiscal periods","prompt":"Get the GAAP basic earnings per share history for Microsoft from SEC EDGAR using the us-gaap taxonomy — I'm building a valuation model and need the actual reported figures across the last 12 fiscal periods, not estimates."},{"title":"Retrieve gross profit series for modeling","prompt":"Fetch the historical gross profit data for Nvidia from SEC EDGAR filings — I want the reported values, filing dates, and fiscal periods so I can track margin trends over the past several years in my financial model."}],"resultDescription":"Returns a JSON object with the ticker, source (sec_edgar), as-of timestamp, and a data object containing the XBRL tag name, taxonomy, human-readable label, unit (e.g. USD), count of data points, and an array of time-series entries each with value, start/end dates, fiscal year, fiscal period, SEC form type, filing date, frame, and accession number.","failureModes":["Invalid or unknown ticker returns empty series or 404","Requested XBRL tag does not exist for the given taxonomy — returns empty data","taxonomy parameter set to unsupported value — may return error or empty result","limit exceeds maximum of 100 — returns validation error","Ticker has no SEC filings (non-US or private company) — returns no data","Payment failure via x402/USDC results in 402 response blocking data access"],"whenToPreferThis":"Use this endpoint when you need structured, historical financial statement data (XBRL concepts) directly sourced from SEC EDGAR filings — ideal for fundamental analysis, financial modeling, or auditing reported figures for US public companies. Prefer this over market data endpoints when you need the actual reported accounting values (revenue, EPS, net income, assets) across fiscal periods rather than real-time prices or estimates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:52:20.227Z","isFirstParty":false}