{"uid":"cap_es_2Z1WpE2wJgq5zkZrM0","slug":"x402stock-dividends-api-5cc2a2a9","name":"x402stock Dividends 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/dividends/%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":["limit"],"properties":{"limit":{"type":"integer","default":10,"maximum":1000,"exclusiveMinimum":0}},"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":["count","dividends"],"properties":{"count":{"type":"number"},"dividends":{"type":"array","items":{"type":"object","required":["cash_amount","currency","dividend_type","frequency","declaration_date","ex_dividend_date","record_date","pay_date"],"properties":{"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"pay_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"frequency":{"anyOf":[{"type":"number"},{"type":"null"}]},"cash_amount":{"type":"number"},"record_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"dividend_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"declaration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"ex_dividend_date":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":{"count":1,"dividends":[{"currency":"USD","pay_date":"2026-05-14","frequency":4,"cash_amount":0.27,"record_date":"2026-05-11","dividend_type":"CD","declaration_date":"2026-04-30","ex_dividend_date":"2026-05-11"}]},"as_of":"2026-05-29T20:00:00.000Z","source":"x402stock","ticker":"AAPL"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_NLn6FUP1p2d0vUfYVcVZy","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 historical and upcoming dividend records for a given US stock or ETF ticker, paid per-call in USDC via x402 on Base.","exampleAgentPrompt":"Pull the last 10 dividend payments for AAPL — I want to see the cash amount, ex-dividend date, pay date, and how frequently they pay.","exampleUseCases":[{"title":"Next dividend payment lookup","prompt":"When is the next dividend payment for MSFT? I need the ex-dividend date, pay date, and how much per share they're planning to pay."},{"title":"ETF dividend yield analysis","prompt":"Pull the full dividend history for VYM and SPY — I want to compare how much they pay per quarter, how frequently they distribute, and whether the amounts have been growing over time."},{"title":"Income stock dividend screening","prompt":"Check the dividend records for KO and JNJ — I want to see if they're consistent payers, what the cash amount per share looks like, and how often they pay throughout the year."}],"resultDescription":"A JSON object containing the ticker symbol, a data-as-of timestamp, and an array of dividend records. Each record includes cash_amount, currency, dividend_type (e.g. 'CD' for cash dividend), frequency (e.g. 4 for quarterly), declaration_date, ex_dividend_date, record_date, and pay_date.","failureModes":["Invalid or unknown ticker returns empty dividend array or 404","Payment failure via x402 (insufficient USDC balance) results in 402 Payment Required","limit parameter out of range (<=0 or >1000) returns 400 validation error","Network or upstream data provider outage results in 5xx error","Ticker with no dividend history returns count of 0 and empty dividends array"],"whenToPreferThis":"Use this endpoint when you need structured, per-ticker dividend history or upcoming payment schedules for US stocks and ETFs, especially in a no-account, pay-per-call context with USDC via x402 on Base. Prefer this over broker APIs when you need lightweight, agent-friendly access without API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:05:37.587Z","isFirstParty":false}