# x402stock Ticker Details Lookup

> x402stock Ticker Details Lookup is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns detailed company/instrument profile data for a given ticker symbol, including financials, address, SIC code, market cap, and branding assets.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/ticker/%7Bticker%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-ticker-details-lookup-75bbc4ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_94iGyzltn05UiPzUsF1au

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-ticker-details-lookup-75bbc4ee
```

Example prompt: Pull up the full company profile for AAPL — I want to see the market cap, number of employees, what exchange it trades on, and a brief description of the business.

## When to prefer this

Use this endpoint when you need rich company metadata for a US-listed stock, ETF, or other exchange-traded instrument — especially CIK, SIC code, employee count, market cap, or branding assets — and you want pay-per-call USDC pricing with no API key required. Prefer this over general web search when you need structured, machine-readable financial profile data tied to a specific ticker.

## Known failure modes

- Unknown or invalid ticker returns 404 or empty data object
- Delisted or OTC-only tickers may return limited fields
- Rate limiting or payment failure returns 402 if USDC payment is not accepted
- Ticker for non-US instruments may return incomplete address or SIC data
- Temporary upstream data provider outage returns 5xx error

## How this service works

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.

## Output

A JSON object containing the ticker's company profile: legal name, CIK, instrument type (e.g. CS for common stock), phone, active status, locale, market, mailing address, currency, homepage, icon and logo URLs, SIC code and description, employee count, IPO list date, market cap, shares outstanding, composite and share-class FIGI identifiers, and primary exchange. Also includes the as_of timestamp and data source label.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "cik": "0000320193",
   "name": "Apple Inc.",
   "type": "CS",
   "phone": "(408) 996-1010",
   "active": true,
   "locale": "us",
   "market": "stocks",
   "address": {
    "city": "CUPERTINO",
    "state": "CA",
    "address1": "ONE APPLE PARK WAY",
    "postal_code": "95014"
   },
   "currency": "usd",
   "homepage": "https://www.apple.com",
   "icon_url": "https://api.massive.com/v1/reference/company-branding/example/icon.png",
   "logo_url": "https://api.massive.com/v1/reference/company-branding/example/logo.svg",
   "sic_code": "3571",
   "employees": 166000,
   "list_date": "1980-12-12",
   "market_cap": 4589945623560,
   "description": "Apple designs and sells consumer electronics, software, and services.",
   "composite_figi": "BBG000B9XRY4",
   "sic_description": "ELECTRONIC COMPUTERS",
   "primary_exchange": "XNAS",
   "share_class_figi": "BBG001S5N8V8",
   "shares_outstanding": 14687356000
  },
  "as_of": "2026-05-29T20:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-ticker-details-lookup-75bbc4ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)