---
title: "Get one asset by chain and address"
url: https://docs.truemarkets.co/api/gateway/get-asset
description: "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."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get one asset by chain and 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.

## Request

```
GET https://api.truemarkets.co/v1/gateway/assets/{chain}/{address}
```

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `chain` | path | string | yes | Blockchain network the listing sits on, or `hypercore-perp` for a perp. |
| `address` | path | string | yes | Token contract/mint address, or the symbol for a perp listing. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Asset retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | no | Unique asset identifier; pass as `asset_id` when creating an order. |
| `economic_asset_id` | string (uuid) | no | Economic asset this listing lists, shared by its listings on every venue and chain. Absent when the listing is not in the asset catalog. |
| `chain` | string, nullable | no | Blockchain network (null for CeFi assets) |
| `address` | string, nullable | no | Token contract address (null for CeFi assets) |
| `symbol` | string | no | Asset ticker symbol (e.g. BTC, SOL) |
| `name` | string | no | Human-readable asset name |
| `decimals` | integer | no | Token decimal precision |
| `slug` | string | no | URL-safe asset identifier |
| `is_active` | boolean | no |  |
| `status` | string, one of `active`, `preview`, `sell_only`, `transfer_only`, `disabled` | no | 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. |
| `description` | string | no |  |
| `website` | string | no |  |
| `icon` | string, nullable | no | Icon image URL |
| `tradeable` | boolean | no | Whether this asset can be traded directly |
| `stable` | boolean | no | Whether this is a stablecoin |
| `venue` | string, one of `defi`, `cefi` | no | The trading venue to filter by. * **defi** — Decentralized exchange (on-chain swaps). * **cefi** — Centralized exchange (off-chain order book). |
| `type` | string, one of `spot`, `perp` | no | Whether the asset is spot or a perpetual (perp). |
| `asset_class` | string, one of `crypto`, `stock` | no | 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. |
| `issuer` | string, one of `coinbase`, `robinhood` | no | The company that issues a tokenized stock; absent for any other listing. |
| `image` | object | no | Asset image URLs at various resolutions |
| `image.thumb` | string | no |  |
| `image.small` | string | no |  |
| `image.large` | string | no |  |
| `market_data` | object | no | Supply-side market data |
| `market_data.circulating_supply` | integer (int64) | no |  |
| `market_data.total_supply` | integer (int64) | no |  |
| `market_data.max_supply` | integer (int64) | no |  |
| `perp` | object, nullable | no | Perp-only market data; present only for perp assets. |
| `perp.funding_rate` | string, nullable | no | Current hourly funding rate. |
| `perp.open_interest` | string, nullable | no | Open interest in base units. |
| `perp.volume_24h` | string, nullable | no | 24h notional volume. |
| `perp.max_leverage` | integer, nullable | no | Maximum leverage supported for this perp. |
| `socials` | object | no | Social media links |
| `socials.x_username` | string | no |  |
| `socials.facebook_username` | string | no |  |
| `socials.subreddit_url` | string | no |  |
| `socials.official_forum_url` | string | no |  |
| `networks` | array of object | yes |  |
| `networks[].network` | string | yes | Canonical network name for this deposit/withdrawal rail (e.g. `bitcoin`). |
| `networks[].compatible_networks` | array of string | yes | Additional network names whose deposits route to the same address as `network`, including `network` itself. Any of these is an accepted `network` value for a CeFi transfer. |
| `settlement` | string, one of `paxos`, `defi` | no | Custody rail a CeFi spot listing settles on; absent for any other listing. |
| `cefi_instrument` | string | no | 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 of string, one of `market`, `limit` | yes | Order types the listing accepts. |

### 404

Not found

### 500

Internal server error
