API reference / Reference & search

Reference & search

Company data, ticker search, peers, and market reference catalogs.

6 endpoints. Pay per call in USDC via x402 with no account, or get unlimited calls for $99/mo. Every response is shaped { ticker, data, source, as_of }.

GET/api/v1/ticker/{ticker}$0.01

Company / ticker reference data

Company name, exchange, market cap, share class, SIC code, address, and other reference fields for a US-listed ticker.

Example request
GET /api/v1/ticker/AAPL
Response type (TypeScript)
interface TickerResponse {
  ticker: string;
  data: {
    name: string;
    market: string;
    locale: string;
    type: string;
    primary_exchange: string;
    currency: string;
    active: boolean;
    cik: string;
    composite_figi: string;
    share_class_figi: string;
    market_cap: number;
    sic_code: string;
    sic_description: string;
    description: string;
    homepage: string;
    phone: string;
    address: {
      address1: string;
      city: string;
      state: string;
      postal_code: string;
    };
    list_date: string;
    employees: number;
    shares_outstanding: number;
    logo_url: string;
    icon_url: string;
  };
  source: string;
  as_of: string;
}
Example response (click to expand)
{
  "ticker": "AAPL",
  "data": {
    "name": "Apple Inc.",
    "market": "stocks",
    "locale": "us",
    "type": "CS",
    "primary_exchange": "XNAS",
    "currency": "usd",
    "active": true,
    "cik": "0000320193",
    "composite_figi": "BBG000B9XRY4",
    "share_class_figi": "BBG001S5N8V8",
    "market_cap": 4583336313360,
    "sic_code": "3571",
    "sic_description": "ELECTRONIC COMPUTERS",
    "description": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products targeted at consumers and businesses. Apple's iPhone makes up a majority of the firm sales, and Apple's other products like Mac, iPad, and Watch are designed around the iPhone as the focal point of an expansive software ecosystem. Apple has progressively worked to add new applications, like streaming video, subscription bundles, and augmented reality. The firm designs its own software and semiconductors while working with subcontractors like Foxconn and TSMC to build its products and chips. Slightly less than half of Apple's sales come directly through its flagship stores, with a majority of sales coming indirectly through partnerships and distribution.",
    "homepage": "https://www.apple.com",
    "phone": "(408) 996-1010",
    "address": {
      "address1": "ONE APPLE PARK WAY",
      "city": "CUPERTINO",
      "state": "CA",
      "postal_code": "95014"
    },
    "list_date": "1980-12-12",
    "employees": 166000,
    "shares_outstanding": 14687356000,
    "logo_url": "https://api.massive.com/v1/reference/company-branding/YXBwbGUuY29t/images/2025-04-04_logo.svg",
    "icon_url": "https://api.massive.com/v1/reference/company-branding/YXBwbGUuY29t/images/2025-04-04_icon.png"
  },
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:15.005Z"
}
GET/api/v1/tickers$0.01

Search / list tickers across stocks, crypto, forex, and indices

Find tickers by free-text `?search=` (name or symbol) across asset classes via `?market=stocks|crypto|fx|indices` (default stocks), with optional `?type=`, `?exchange=`, `?active=`, `?limit=`. Returns symbol, name, market, exchange, type, and identifiers. Use to discover crypto pairs (X:BTCUSD), FX pairs (C:EURUSD), and index symbols (I:SPX).

Example request
GET /api/v1/tickers
Response type (TypeScript)
interface TickersResponse {
  source: string;
  as_of: string;
  count: number;
  tickers: Array<{
    ticker: string;
    name: string;
    market: string;
    locale: string;
    primary_exchange: string;
    type: string;
    active: boolean;
    currency: string;
    cik: string;
    composite_figi: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:52.314Z",
  "count": 7,
  "tickers": [
    {
      "ticker": "AAPB",
      "name": "GraniteShares ETF Trust GraniteShares 2x Long AAPL Daily ETF",
      "market": "stocks",
      "locale": "us",
      "primary_exchange": "XNAS",
      "type": "ETF",
      "active": true,
      "currency": "usd",
      "cik": "0001689873",
      "composite_figi": "BBG0193F21N2"
    },
    {
      "ticker": "AAPD",
      "name": "Direxion Shares ETF Trust Direxion Daily AAPL Bear 1X ETF",
      "market": "stocks",
      "locale": "us",
      "primary_exchange": "XNAS",
      "type": "ETF",
      "active": true,
      "currency": "usd",
      "cik": null,
      "composite_figi": "BBG0193YGJ57"
    },
    {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "market": "stocks",
      "locale": "us",
      "primary_exchange": "XNAS",
      "type": "CS",
      "active": true,
      "currency": "usd",
      "cik": "0000320193",
      "composite_figi": "BBG000B9XRY4"
    },
    {
      "ticker": "AAPU",
      "name": "Direxion Shares ETF Trust Direxion Daily AAPL Bull 2X ETF",
      "market": "stocks",
      "locale": "us",
      "primary_exchange": "XNAS",
      "type": "ETF",
      "active": true,
      "currency": "usd",
      "cik": null,
      "composite_figi": "BBG0193YBZ92"
    },
    {
      "ticker": "AAPW",
      "name": "Roundhill AAPL WeeklyPay ETF",
      "market": "stocks",
      "locale": "us",
      "primary_exchange": "BATS",
      "type": "ETF",
      "active": true,
      "currency": "usd",
      "cik": null,
      "composite_figi": "BBG01SCFVRC3"
    },
    {
      "ticker": "AAPY",
      "name": "Kurv Yield Premium Strategy Apple (AAPL) ETF",
      "market": "stocks",
      "locale": "us",
      "primary_exchange": "BATS",
      "type": "ETF",
      "active": true,
      "currency": "usd",
      "cik": "0001848758",
      "composite_figi": "BBG01QY0GMH9"
    },
    {
      "ticker": "APLY",
      "name": "YieldMax AAPL Option Income Strategy ETF",
      "market": "stocks",
      "locale": "us",
      "primary_exchange": "ARCX",
      "type": "ETS",
      "active": true,
      "currency": "usd",
      "cik": null,
      "composite_figi": "BBG01FV8K8Y6"
    }
  ]
}
GET/api/v1/exchanges$0.01

US stock exchanges & market centers reference

Reference list of US equity exchanges and market centers with names, MICs, operating MICs, and SIP participant IDs.

Example request
GET /api/v1/exchanges
Response type (TypeScript)
interface ExchangesResponse {
  source: string;
  as_of: string;
  count: number;
  exchanges: Array<{
    id: number;
    type: string;
    name: string;
    acronym: string;
    mic: string;
    operating_mic: string;
    participant_id: string;
    url: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:44.885Z",
  "count": 27,
  "exchanges": [
    {
      "id": 1,
      "type": "exchange",
      "name": "NYSE American, LLC",
      "acronym": "AMEX",
      "mic": "XASE",
      "operating_mic": "XNYS",
      "participant_id": "A",
      "url": "https://www.nyse.com/markets/nyse-american"
    },
    {
      "id": 2,
      "type": "exchange",
      "name": "Nasdaq Texas, Inc.",
      "acronym": null,
      "mic": "XBOS",
      "operating_mic": "XNAS",
      "participant_id": "B",
      "url": "https://www.nasdaq.com/solutions/nasdaq-bx-stock-market"
    },
    {
      "id": 3,
      "type": "exchange",
      "name": "NYSE National, Inc.",
      "acronym": "NSX",
      "mic": "XCIS",
      "operating_mic": "XNYS",
      "participant_id": "C",
      "url": "https://www.nyse.com/markets/nyse-national"
    },
    {
      "id": 4,
      "type": "TRF",
      "name": "FINRA Alternative Display Facility",
      "acronym": null,
      "mic": "XADF",
      "operating_mic": "FINR",
      "participant_id": "D",
      "url": "https://www.finra.org"
    },
    {
      "id": 5,
      "type": "SIP",
      "name": "Unlisted Trading Privileges",
      "acronym": null,
      "mic": null,
      "operating_mic": "XNAS",
      "participant_id": "E",
      "url": "https://www.utpplan.com"
    },
    {
      "id": 6,
      "type": "TRF",
      "name": "International Securities Exchange, LLC - Stocks",
      "acronym": null,
      "mic": "XISE",
      "operating_mic": "XNAS",
      "participant_id": "I",
      "url": "https://nasdaq.com/solutions/nasdaq-ise"
    },
    {
      "id": 7,
      "type": "exchange",
      "name": "Cboe EDGA",
      "acronym": null,
      "mic": "EDGA",
      "operating_mic": "XCBO",
      "participant_id": "J",
      "url": "https://www.cboe.com/us/equities"
    },
    {
      "id": 8,
      "type": "exchange",
      "name": "Cboe EDGX",
      "acronym": null,
      "mic": "EDGX",
      "operating_mic": "XCBO",
      "participant_id": "K",
      "url": "https://www.cboe.com/us/equities"
    },
    {
      "id": 9,
      "type": "exchange",
      "name": "NYSE Texas, Inc.",
      "acronym": null,
      "mic": "XCHI",
      "operating_mic": "XNYS",
      "participant_id": "M",
      "url": "https://www.nyse.com/markets/nyse-texas"
    },
    {
      "id": 10,
      "type": "exchange",
      "name": "New York Stock Exchange",
      "acronym": null,
      "mic": "XNYS",
      "operating_mic": "XNYS",
      "participant_id": "N",
      "url": "https://www.nyse.com"
    },
    {
      "id": 11,
      "type": "exchange",
      "name": "NYSE Arca, Inc.",
      "acronym": null,
      "mic": "ARCX",
      "operating_mic": "XNYS",
      "participant_id": "P",
      "url": "https://www.nyse.com/markets/nyse-arca"
    },
    {
      "id": 12,
      "type": "exchange",
      "name": "Nasdaq",
      "acronym": null,
      "mic": "XNAS",
      "operating_mic": "XNAS",
      "participant_id": "T",
      "url": "https://www.nasdaq.com"
    },
    {
      "id": 13,
      "type": "SIP",
      "name": "Consolidated Tape Association",
      "acronym": null,
      "mic": null,
      "operating_mic": "XNYS",
      "participant_id": "S",
      "url": "https://www.nyse.com/data/cta"
    },
    {
      "id": 14,
      "type": "exchange",
      "name": "Long-Term Stock Exchange",
      "acronym": null,
      "mic": "LTSE",
      "operating_mic": "LTSE",
      "participant_id": "L",
      "url": "https://www.ltse.com"
    },
    {
      "id": 15,
      "type": "exchange",
      "name": "Investors Exchange",
      "acronym": null,
      "mic": "IEXG",
      "operating_mic": "IEXG",
      "participant_id": "V",
      "url": "https://www.iextrading.com"
    },
    {
      "id": 16,
      "type": "TRF",
      "name": "Cboe Stock Exchange",
      "acronym": null,
      "mic": "CBSX",
      "operating_mic": "XCBO",
      "participant_id": "W",
      "url": "https://www.cboe.com"
    },
    {
      "id": 17,
      "type": "exchange",
      "name": "Nasdaq Philadelphia Exchange LLC",
      "acronym": null,
      "mic": "XPHL",
      "operating_mic": "XNAS",
      "participant_id": "X",
      "url": "https://www.nasdaq.com/solutions/nasdaq-phlx"
    },
    {
      "id": 18,
      "type": "exchange",
      "name": "Cboe BYX",
      "acronym": null,
      "mic": "BATY",
      "operating_mic": "XCBO",
      "participant_id": "Y",
      "url": "https://www.cboe.com/us/equities"
    },
    {
      "id": 19,
      "type": "exchange",
      "name": "Cboe BZX",
      "acronym": null,
      "mic": "BATS",
      "operating_mic": "XCBO",
      "participant_id": "Z",
      "url": "https://www.cboe.com/us/equities"
    },
    {
      "id": 20,
      "type": "exchange",
      "name": "MIAX Pearl",
      "acronym": null,
      "mic": "EPRL",
      "operating_mic": "MIHI",
      "participant_id": "H",
      "url": "https://www.miaxoptions.com/alerts/pearl-equities"
    },
    {
      "id": 21,
      "type": "exchange",
      "name": "Members Exchange",
      "acronym": null,
      "mic": "MEMX",
      "operating_mic": "MEMX",
      "participant_id": "U",
      "url": "https://www.memx.com"
    },
    {
      "id": 22,
      "type": "exchange",
      "name": "24X National Exchange LLC",
      "acronym": "24X",
      "mic": "24EQ",
      "operating_mic": "24EQ",
      "participant_id": "G",
      "url": "https://24exchange.com/"
    },
    {
      "id": 23,
      "type": "exchange",
      "name": "Texas Stock Exchange LLC",
      "acronym": "TXSE",
      "mic": "TXSE",
      "operating_mic": "TXSE",
      "participant_id": "F",
      "url": "https://txse.com/"
    },
    {
      "id": 62,
      "type": "ORF",
      "name": "OTC Equity Security",
      "acronym": null,
      "mic": "OOTC",
      "operating_mic": "FINR",
      "participant_id": null,
      "url": "https://www.finra.org/filing-reporting/over-the-counter-reporting-facility-orf"
    },
    {
      "id": 201,
      "type": "
… (truncated — call the endpoint for the full response)
GET/api/v1/conditions$0.01

Trade & quote condition codes reference

Reference catalog of trade/quote condition codes (the numeric `conditions` seen on trades) with names, types, data types, and SIP mappings.

Example request
GET /api/v1/conditions
Response type (TypeScript)
interface ConditionsResponse {
  source: string;
  as_of: string;
  count: number;
  conditions: Array<{
    id: number;
    type: string;
    name: string;
    data_types: string[];
    sip_mapping: {
      UTP: string;
    };
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:47.647Z",
  "count": 50,
  "conditions": [
    {
      "id": 1,
      "type": "sale_condition",
      "name": "Acquisition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "A"
      }
    },
    {
      "id": 2,
      "type": "sale_condition",
      "name": "Average Price Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "FINRA_TDDS": "W",
        "CTA": "B",
        "UTP": "W"
      }
    },
    {
      "id": 3,
      "type": "sale_condition",
      "name": "Automatic Execution",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "E"
      }
    },
    {
      "id": 4,
      "type": "sale_condition",
      "name": "Bunched Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "B"
      }
    },
    {
      "id": 5,
      "type": "sale_condition",
      "name": "Bunched Sold Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "G"
      }
    },
    {
      "id": 6,
      "type": "sale_condition",
      "name": "CAP Election",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "I"
      }
    },
    {
      "id": 7,
      "type": "sale_condition",
      "name": "Cash Sale",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "C",
        "UTP": "C",
        "FINRA_TDDS": "C"
      }
    },
    {
      "id": 8,
      "type": "sale_condition",
      "name": "Closing Prints",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "6"
      }
    },
    {
      "id": 9,
      "type": "sale_condition",
      "name": "Cross Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "X",
        "UTP": "X"
      }
    },
    {
      "id": 10,
      "type": "sale_condition",
      "name": "Derivatively Priced",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "4",
        "UTP": "4"
      }
    },
    {
      "id": 11,
      "type": "sale_condition",
      "name": "Distribution",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "D"
      }
    },
    {
      "id": 12,
      "type": "sale_condition",
      "name": "Form T/Extended Hours",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "T",
        "UTP": "T",
        "FINRA_TDDS": "T"
      }
    },
    {
      "id": 13,
      "type": "sale_condition",
      "name": "Extended Hours (Sold Out Of Sequence)",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "FINRA_TDDS": "U",
        "CTA": "U",
        "UTP": "U"
      }
    },
    {
      "id": 14,
      "type": "sale_condition",
      "name": "Intermarket Sweep",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "F",
        "UTP": "F"
      }
    },
    {
      "id": 15,
      "type": "sale_condition",
      "name": "Market Center Official Close",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "M",
        "UTP": "M"
      }
    },
    {
      "id": 16,
      "type": "sale_condition",
      "name": "Market Center Official Open",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "Q",
        "UTP": "Q"
      }
    },
    {
      "id": 17,
      "type": "sale_condition",
      "name": "Market Center Opening Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "O"
      }
    },
    {
      "id": 18,
      "type": "sale_condition",
      "name": "Market Center Reopening Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "5"
      }
    },
    {
      "id": 19,
      "type": "sale_condition",
      "name": "Market Center Closing Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "6"
      }
    },
    {
      "id": 20,
      "type": "sale_condition",
      "name": "Next Day",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "N",
        "FINRA_TDDS": "N",
        "CTA": "N"
      }
    },
    {
      "id": 21,
      "type": "sale_condition",
      "name": "Price Variation Trade",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "H",
        "UTP": "H"
      }
    },
    {
      "id": 22,
      "type": "sale_condition",
      "name": "Prior Reference Price",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "P",
        "UTP": "P",
        "FINRA_TDDS": "P"
      }
    },
    {
      "id": 23,
      "type": "sale_condition",
      "name": "Rule 155 Trade (AMEX)",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "K",
        "UTP": "K"
      }
    },
    {
      "id": 24,
      "type": "sale_condition",
      "name": "Rule 127 (NYSE Only)",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "K"
      }
    },
    {
      "id": 25,
      "type": "sale_condition",
      "name": "Opening Prints",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "O"
      }
    },
    {
      "id": 27,
      "type": "sale_condition",
      "name": "Stopped Stock (Regular Trade)",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "1"
      }
    },
    {
      "id": 28,
      "type": "sale_condition",
      "name": "Re-Opening Prints",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "5"
      }
    },
    {
      "id": 29,
      "type": "sale_condition",
      "name": "Seller",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "R",
        "FINRA_TDDS": "R",
        "CTA": "R"
 
… (truncated — call the endpoint for the full response)
GET/api/v1/ticker-types$0.01

Ticker type codes reference (CS, ETF, ADRC, …)

Reference list of security type codes used in ticker reference data (e.g. CS = Common Stock, ETF, PFD, WARRANT) with descriptions.

Example request
GET /api/v1/ticker-types
Response type (TypeScript)
interface TickerTypesResponse {
  source: string;
  as_of: string;
  count: number;
  types: Array<{
    code: string;
    description: string;
    asset_class: string;
    locale: string;
  }>;
}
Example response (click to expand)
{
  "source": "x402stock",
  "as_of": "2026-05-31T19:19:49.943Z",
  "count": 24,
  "types": [
    {
      "code": "CS",
      "description": "Common Stock",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "PFD",
      "description": "Preferred Stock",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "WARRANT",
      "description": "Warrant",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "RIGHT",
      "description": "Rights",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "BOND",
      "description": "Corporate Bond",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ETF",
      "description": "Exchange Traded Fund",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ETN",
      "description": "Exchange Traded Note",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ETV",
      "description": "Exchange Traded Vehicle",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "SP",
      "description": "Structured Product",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ADRC",
      "description": "American Depository Receipt Common",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ADRP",
      "description": "American Depository Receipt Preferred",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ADRW",
      "description": "American Depository Receipt Warrants",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ADRR",
      "description": "American Depository Receipt Rights",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "FUND",
      "description": "Fund",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "BASKET",
      "description": "Basket",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "UNIT",
      "description": "Unit",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "LT",
      "description": "Liquidating Trust",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "OS",
      "description": "Ordinary Shares",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "GDR",
      "description": "Global Depository Receipts",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "OTHER",
      "description": "Other Security Type",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "NYRS",
      "description": "New York Registry Shares",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "AGEN",
      "description": "Agency Bond",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "EQLK",
      "description": "Equity Linked Bond",
      "asset_class": "stocks",
      "locale": "us"
    },
    {
      "code": "ETS",
      "description": "Single-security ETF",
      "asset_class": "stocks",
      "locale": "us"
    }
  ]
}