# Massive x402 API – Ticker Reference Data

> Massive x402 API – Ticker Reference Data is a paid API for AI agents from agent.massive.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://agent.massive.com/v3/reference/tickers/%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/massive-x402-api-ticker-reference-data-79c1455b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dvwsaqGv7nLkXsXy49wH5

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 massive-x402-api-ticker-reference-data-79c1455b
```

Example prompt: Pull up the reference details for AAPL — I want the company description, market cap, primary exchange, SIC code, and listing date.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/massive-x402-api-ticker-reference-data-79c1455b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.massive.com](https://www.zero.xyz/host/agent.massive.com/llms.txt)