# x402stock.xyz Ticker Detail Lookup

> x402stock.xyz Ticker Detail Lookup is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status healthy (last checked 2026-09-13, last successful call 2026-09-02).

Returns detailed profile data for a single US stock ticker by symbol, including company info, market cap, SIC codes, identifiers, and logo URLs.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/ticker/AAPL
- Price: $0.01/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-13
- Last successful call: 2026-09-02
- Success rate: 100% of calls made through Zero
- Activations on Zero: 4
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-157e6ff9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wXj2HSVqmN5h3L1w7LuHk

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-xyz-157e6ff9
```

Example prompt: Can you pull up the full company profile for AAPL — I want the market cap, employee count, SIC industry code, exchange, and logo URL?

## When to prefer this

Use this endpoint when you need rich company-level fundamental data (market cap, SIC, FIGI, CIK, logo, address, employees) for a specific known ticker symbol. Prefer it over the search endpoint when you already know the exact ticker and need full profile details rather than just symbol/name/exchange lookup.

## Known failure modes

- Unknown or invalid ticker symbol returns 404 or empty data
- Ticker exists but has null fields for less-covered securities
- Rate limiting or payment failure returns 402 if USDC payment not processed
- Delisted or inactive tickers may return stale or partial data
- Non-US tickers may not be supported

## How this service works

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.

## Output

A JSON object containing the ticker symbol, company name, exchange, market, locale, active status, CIK, composite FIGI, share class FIGI, market cap, SIC code and description, company description, homepage URL, phone, address, list date, employee count, shares outstanding, logo URL, and icon URL, plus an as_of timestamp and data source.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "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",
     "properties": {}
    }
   },
   "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": [
        "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"
            }
           },
           "additionalPrope
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-157e6ff9/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)