For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/get-asset.md.

Get one asset by chain and address

GET
/assets/{chain}/{address}

Returns the single catalog listing held at address on chain, in the same shape a GET /assets row takes. Both parameters match case-insensitively, so a checksummed and a lowercased EVM address resolve to the same listing.

Unlike GET /assets, this lookup applies no status, venue, or asset class filter, so a listing the browse list hides for its status (for example transfer_only) is still returned here and a client holding the asset can read its real state. Deactivated listings are not returned.

Path Parameters

chain*string

Blockchain network the listing sits on, or hypercore-perp for a perp.

address*string

Token contract/mint address, or the symbol for a perp listing.

Response Body

Asset retrieved successfully

application/json
  1. response

A single tradeable asset

id?string

Unique asset identifier; pass as asset_id when creating an order.

Formatuuid
economic_asset_id?string

Economic asset this listing lists, shared by its listings on every venue and chain. Absent when the listing is not in the asset catalog.

Formatuuid
chain?|

Blockchain network (null for CeFi assets)

address?|

Token contract address (null for CeFi assets)

symbol?string

Asset ticker symbol (e.g. BTC, SOL)

name?string

Human-readable asset name

decimals?integer

Token decimal precision

Range0 <= value <= 255
slug?string

URL-safe asset identifier

is_active?boolean
status?string

Per-listing trading status. GET /assets lists active and sell_only listings, while GET /assets/{chain}/{address} returns any status, so clients gate on this field directly.

Value in"active""preview""sell_only""transfer_only""disabled"
description?string
website?string
icon?|

Icon image URL

tradeable?boolean

Whether this asset can be traded directly

stable?boolean

Whether this is a stablecoin

venue?Venue

The trading venue to filter by.

  • defi — Decentralized exchange (on-chain swaps).
  • cefi — Centralized exchange (off-chain order book).
Value in"defi""cefi"
type?ProductType

Whether the asset is spot or a perpetual (perp).

Value in"spot""perp"
asset_class?AssetClass

The underlying instrument, orthogonal to product type. A stock is a tokenized equity, which is an ordinary spot or perp listing and quotes and executes as one. Absent on servers predating the field, which list crypto only.

Value in"crypto""stock"
issuer?Issuer

The company that issues a tokenized stock; absent for any other listing.

Value in"coinbase""robinhood"
image?

Asset image URLs at various resolutions

market_data?

Supply-side market data

perp?|null

Perp-only market data; present only for perp assets.

socials?

Social media links

networks*array<>
settlement?string

Custody rail a CeFi spot listing settles on; absent for any other listing.

Value in"paxos""defi"
cefi_instrument?string

TrueX instrument symbol a CeFi spot listing trades on; absent for any other listing and while the instrument is not yet resolved.

order_types*array<>

Order types the listing accepts.

Example Request
curl -X GET 'https://api.truemarkets.co/v1/gateway/assets/base/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "economic_asset_id": "7f93aecf-1e3c-4189-b692-a8b4a0ef8e5b",  "chain": "string",  "address": "string",  "symbol": "string",  "name": "string",  "decimals": 0,  "slug": "string",  "is_active": true,  "status": "active",  "description": "string",  "website": "string",  "icon": "string",  "tradeable": true,  "stable": true,  "venue": "defi",  "type": "spot",  "asset_class": "crypto",  "issuer": "coinbase",  "image": {    "thumb": "string",    "small": "string",    "large": "string"  },  "market_data": {    "circulating_supply": 0,    "total_supply": 0,    "max_supply": 0  },  "perp": {    "funding_rate": "string",    "open_interest": "string",    "volume_24h": "string",    "max_leverage": 0  },  "socials": {    "x_username": "string",    "facebook_username": "string",    "subreddit_url": "string",    "official_forum_url": "string"  },  "networks": [    {      "network": "bitcoin",      "compatible_networks": [        "string"      ]    }  ],  "settlement": "paxos",  "cefi_instrument": "NVDAC-USDC",  "order_types": [    "market",    "limit"  ]}