{"uid":"cap_dvwsaqGv7nLkXsXy49wH5","slug":"massive-x402-api-ticker-reference-data-79c1455b","name":"Massive x402 API – Ticker Reference Data","description":"US stock market data, sold per request over x402. Every path here answers 402 with the payment terms in the PAYMENT-REQUIRED header, and answers with the data once the payment settles. No account, no API key, no subscription.","url":"https://agent.massive.com/v3/reference/tickers/%7Bticker%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"status":"OK","results":{"cik":"0000320193","name":"Apple Inc.","type":"CS","active":true,"locale":"us","market":"stocks","ticker":"AAPL","address":{"city":"Cupertino","state":"CA","address1":"One Apple Park Way","postal_code":"95014"},"branding":{"icon_url":"https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_icon.png","logo_url":"https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_logo.svg"},"sic_code":"3571","list_date":"1980-12-12","round_lot":100,"market_cap":2771126040150,"description":"Apple designs a wide variety of consumer electronic devices, including smartphones (iPhone), tablets (iPad), PCs (Mac), smartwatches (Apple Watch), AirPods, and TV boxes (Apple TV), among others. The iPhone makes up the majority of Apple's total revenue. In addition, Apple offers its customers a variety of services such as Apple Music, iCloud, Apple Care, Apple TV+, Apple Arcade, Apple Card, and Apple Pay, among others. Apple's products run internally developed software and semiconductors, and the firm is well known for its integration of hardware, software and services. Apple's products are distributed online as well as through company-owned stores and third-party retailers. The company generates roughly 40% of its revenue from the Americas, with the remainder earned internationally.","ticker_root":"AAPL","homepage_url":"https://www.apple.com","phone_number":"(408) 996-1010","currency_name":"usd","composite_figi":"BBG000B9XRY4","sic_description":"ELECTRONIC COMPUTERS","total_employees":154000,"primary_exchange":"XNAS","share_class_figi":"BBG001S5N8V8","weighted_shares_outstanding":16334371000,"share_class_shares_outstanding":16406400000},"request_id":"31d59dda-80e5-4721-8496-d0d32a654afe"}},"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_0LeheVyGDeh4jWGv4rN2Y","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 detailed reference information for a single US stock ticker, including company profile, market cap, SIC code, exchange, branding, and address, paid per-request via x402 micropayment.","exampleAgentPrompt":"Pull up the reference details for AAPL — I want the company description, market cap, primary exchange, SIC code, and listing date.","exampleUseCases":[{"title":"Enrich portfolio with company profiles","prompt":"For each ticker in my portfolio — AAPL, MSFT, and GOOGL — pull their full company profiles including market cap, SIC description, total employees, and primary exchange."},{"title":"Verify company identity before trade","prompt":"Before I place this order, can you confirm that TSLA is an active common stock trading on a US exchange and give me its CIK and composite FIGI?"},{"title":"Research competitor fundamentals","prompt":"I'm analyzing the semiconductor sector — look up the reference data for NVDA, including its SIC code, market cap, employee count, and headquarters address."}],"resultDescription":"A JSON object with status OK and a results block containing: ticker symbol, company name, CIK, type (e.g. CS for common stock), active status, locale, market, headquarters address, branding icon and logo URLs, SIC code and description, listing date, round lot size, market cap, company description, ticker root, homepage URL, phone number, currency, composite FIGI, share class FIGI, total employees, weighted and share class shares outstanding, plus a request_id.","failureModes":["Invalid or unknown ticker symbol returns an error or empty results","Payment settlement failure results in continued 402 response","Delisted or inactive tickers may return stale or partial data","Malformed ticker path parameter causes a 400 or routing error","Network timeout during payment flow leaves request unresolved"],"whenToPreferThis":"Choose this endpoint when you need authoritative, structured reference data for a single US stock ticker — including company identity, SEC CIK, SIC classification, exchange, market cap, branding, and address — without setting up an account or API key. The x402 micropayment model ($0.01 USDC per call) makes it ideal for low-volume or on-demand lookups by AI agents that need to enrich financial data pipelines or verify company identity programmatically. Prefer it over subscription-based financial data APIs when cost-per-call economics are favorable and you want no-friction access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:35:17.381Z","isFirstParty":false}