Skip to main content
GET
/
v1
/
api-meta
/
spot
/
overview
curl
curl https://api.testnet.arcus.xyz/v1/api-meta/spot/overview

[
  {
    "ticker": "TSM",
    "contractAddress": "0x58FFe4a942d3885bAa22D7520691F611EF09e7AA",
    "name": "Taiwan Semiconductor Manufacturing Company Limited",
    "category": "EQUITIES",
    "logoUrl": "https://branding.dydx.exchange/markets/branding/TSM.png",
    "quote": {
      "price": 468.16669,
      "change24h": 6.04668,
      "changePercent24h": 1.30846,
      "volume24h": 8014171
    },
    "financials": {
      "marketCap": 2442313432000,
      "currency": "usd",
      "peRatio": 33.75,
      "dividendYield": 0.00876498
    }
  }
]
Returns the spot market universe from the spot-router /tokens source of truth, in listed order, augmented with name, logoUrl, quote, and financials from the latest stored market metadata profile when available. Public — no X-API-Key and no signature required. Entries remain present even before the metadata ingester has written a profile row for that ticker; in that case logoUrl is null and the quote / financials fields are null.

Response

Ordered spot market overview entries.

​
ticker
string
required

Spot market ticker symbol.

Example:

"TSM"

​
name
string
required

Display name. The full company name from the stored metadata profile when available, otherwise the name from the spot-router token.

Example:

"Taiwan Semiconductor Manufacturing Company Limited"

​
logoUrl
string<uri> | null
required

Logo URL from the corresponding stored market profile, or null when the ticker has not been ingested yet or the provider has no value.

Example:

"https://branding.dydx.exchange/markets/branding/TSM.png"

​
quote
object
required

Latest price-action snapshot for the spot entry, identical in shape to the quote block on the /markets metadata route. Every field is null until a metadata profile has been ingested for the ticker.

​
financials
object
required

Headline financial metrics. marketCap / currency are sourced by every provider; peRatio / dividendYield are filled by the Finnhub and FMP providers (null for Massive). The revenue (trailing-twelve-month), evToSales, evToEBITDA, and priceToBook fields are FMP-only enrichment: they are present (omitted otherwise) only in responses produced by the FMP provider.

​
contractAddress
string

On-chain contract address for the underlying.

Example:

"0x58FFe4a942d3885bAa22D7520691F611EF09e7AA"

​
category
enum<string>

Category of the underlying. Omitted for tickers outside the classified universe.

Available options:
EQUITIES,
COMMODITIES,
INDICES,
CRYPTO
Example:

"EQUITIES"

Example:
[
  {
    "ticker": "TSM",
    "contractAddress": "0x58FFe4a942d3885bAa22D7520691F611EF09e7AA",
    "name": "Taiwan Semiconductor Manufacturing Company Limited",
    "category": "EQUITIES",
    "logoUrl": "https://branding.dydx.exchange/markets/branding/TSM.png",
    "quote": {
      "price": 468.16669,
      "change24h": 6.04668,
      "changePercent24h": 1.30846,
      "volume24h": 8014171
    },
    "financials": {
      "marketCap": 2442313432000,
      "currency": "usd",
      "peRatio": 33.75,
      "dividendYield": 0.00876498
    }
  }
]