{"uid":"cap_czxkpptzmOaT5YLqjfLJ6","slug":"agents-x402stock-xyz-x402stock-ticker-reference-data-56f36d68","name":"x402stock Ticker Reference Data","description":"Company name, exchange, market cap, share class, SIC code, address, and other reference fields for a US-listed ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.","url":"https://agents.x402stock.xyz/api/v1/ticker/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["name","market","locale","active","cik","composite_figi","share_class_figi","market_cap","sic_code","sic_description","description","homepage","phone","address","list_date","employees","shares_outstanding","logo_url","icon_url"],"properties":{"cik":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"type":"boolean"},"locale":{"type":"string"},"market":{"type":"string"},"address":{"anyOf":[{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"address1":{"type":"string"},"postal_code":{"type":"string"}},"additionalProperties":false},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"homepage":{"anyOf":[{"type":"string"},{"type":"null"}]},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"sic_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"employees":{"anyOf":[{"type":"number"},{"type":"null"}]},"list_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"composite_figi":{"anyOf":[{"type":"string"},{"type":"null"}]},"sic_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_exchange":{"anyOf":[{"type":"string"},{"type":"null"}]},"share_class_figi":{"anyOf":[{"type":"string"},{"type":"null"}]},"shares_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}]}},"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_msRvIGaw79ON_sQerfSN2","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns company reference fields (name, exchange, market cap, SIC code, address, employees, FIGI, and more) for a US-listed ticker symbol.","exampleAgentPrompt":"Pull up the reference details for NVDA — I want the company name, exchange, market cap, SIC code, address, and how many employees they have.","exampleUseCases":[{"title":"Enriching a stock portfolio dashboard","prompt":"For each ticker in my watchlist, starting with MSFT, can you get me the full company profile — name, exchange, market cap, sector code, and headquarters address?"},{"title":"Screening for industry peers by SIC code","prompt":"What is the SIC code and SIC description for JPM? I want to find other banks in the same industry classification."},{"title":"Verifying a ticker is actively listed","prompt":"Is the ticker SPCE still an active listing? Also tell me when it first listed and what its current market cap and share count look like."}],"resultDescription":"A JSON object containing the ticker, data timestamp, and a data block with: company name, market, locale, active status, CIK, composite FIGI, share class FIGI, market cap, SIC code, SIC description, business description, homepage URL, phone, address (street, city, state, ZIP), list date, employee count, shares outstanding, logo URL, and icon URL. Some fields may be null if not available.","failureModes":["Invalid or unknown ticker returns an error or empty data block","Ticker exists but is delisted — active field will be false and some fields may be null","Market cap and employee count may be stale or null for thinly covered securities","Payment failure via x402 (insufficient USDC balance) blocks the request","Rate or network issues from the upstream data provider may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need static or slowly-changing reference/identity fields for a US-listed stock or ETF — company name, SIC classification, exchange, address, FIGI identifiers, employee count, or market cap — rather than real-time price data. Prefer this over price history or OHLCV endpoints when the question is about company identity or classification, not trading data. No API key required; just pay $0.01 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-02T04:41:13.491Z","lastSuccessfullyRanAt":"2026-09-02T04:41:13.491Z","lastHealthCheckAt":"2026-09-08T21:14:03.008Z","isFirstParty":false}