# x402stock Ticker Reference Data

> x402stock Ticker Reference Data is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status healthy (last checked 2026-09-08, last successful call 2026-09-02).

Returns company reference fields (name, exchange, market cap, SIC code, address, employees, FIGI, and more) for a US-listed ticker symbol.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/ticker/{ticker}
- Price: $0.01/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-09-08
- Last successful call: 2026-09-02
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-ticker-reference-data-56f36d68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_czxkpptzmOaT5YLqjfLJ6

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 agents-x402stock-xyz-x402stock-ticker-reference-data-56f36d68
```

Example prompt: Pull up the reference details for NVDA — I want the company name, exchange, market cap, SIC code, address, and how many employees they have.

## When to prefer this

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.

## Known failure modes

- 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

## 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, 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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
      }
     ]
    },
    "d
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-ticker-reference-data-56f36d68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)