---
title: "Equity Metadata"
method: GET
path: "/gateway/v1/equity/meta"
tags: ["Equity"]
---

# Equity Metadata

`GET /gateway/v1/equity/meta`

Returns lightweight identity, logo, and latest USD price metadata for one or more US-listed stocks or ETFs. Symbols are returned in request order. Company and fund identity is cached for 24 hours; prices are cached independently for 1 minute.

## Query parameters

- `symbol` string, required — One or more comma-separated US stock or ETF ticker symbols; at most 20 unique symbols
- `include_tokenized` boolean — Include tokenized counterparts of each stock — issuer-minted crypto tokens tracking the equity, with their chains and contract addresses. Off by default: most symbols have none, and the payload grows with a 20-symbol request.

## Response `200`

OK

- SimpleListResponseEquityMeta
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` EquityMeta[], nullable, required
    - `currency` string, required — Price currency
    - `day_change` number, double — Absolute change from the previous trading-day close
    - `day_change_percent` number, double — Percentage change from the previous trading-day close
    - `logo_url` string, required — Company or fund logo image URL
    - `name` string, required — Company or fund name
    - `price` number, double, required — Latest traded price
    - `price_timestamp` integer, required — Latest-price timestamp as Unix seconds
    - `symbol` string, required — US stock or ETF ticker symbol
    - `tokenized` EquityTokenizedAsset[], nullable — Tokenized counterparts of this stock. Only present when include_tokenized=true and a mapping exists.
      - `chains` EquityTokenizedAssetChain[], nullable, required — Deployments, primary first
        - `chain_id` string, required — Canonical Surf chain id the token is deployed on
        - `contract_address` string, required — Token contract address on that chain
        - `is_primary` boolean, required — Whether this is the issuer's primary deployment
      - `coingecko_id` string — CoinGecko id, for resolving a live quote
      - `issuer_name` string — Entity that issues the tokenized stock, e.g. xStocks, Ondo Finance
      - `issuer_slug` string — Stable issuer identifier
      - `logo_url` string — Token logo image URL
      - `mapping_source` string — How the stock-to-token link was established
      - `name` string, required — Token name, e.g. Tesla xStock
      - `symbol` string, required — Token ticker, e.g. TSLAX
      - `token_id` string, required — Surf token id
      - `verification_status` string — Confidence in the mapping
      - `website_url` string — Issuer or token website
  - `meta` ObjectResponseMeta, required
    - `cached` boolean, required — Whether this response was served from cache
    - `credits_used` integer, required — Credits deducted for this request
    - `empty_reason` string — Hint explaining why the data array is empty, when applicable

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) · [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asksurf/asksurf-public-rest-api/revisions/498f461e81c4/schema)