What your users can trade
The asset catalog lists everything you can trade. Each asset says what it is, where it trades and which network it settles on. You can read it without a token, so you can call it before you create a single user. Your users can trade the assets whose venue is defi.
List assets
Without filters, the catalog returns spot crypto. Perpetual futures and tokenized stocks are opt-in: pass product_type=perp (it filters on each asset's type) or asset_class=stock to list them, or a comma-separated list such as asset_class=crypto,stock to get both.
Keep each asset's id. It's the asset_id you place orders with. The catalog comes back in one response, with no paging.
Read chains and listings from the catalog instead of hard-coding them. New ones appear there first.
- TypeScript
- Python
- curl
const assets = await get("/v1/gateway/assets");
assets = get("/v1/gateway/assets")
curl -s https://api.truemarkets.co/v1/gateway/assets
{
"data": [
{
"id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"symbol": "SOL",
"chain": "solana",
"venue": "defi",
"type": "spot",
"asset_class": "crypto",
"status": "active",
"…": "…"
}
]
}
- TypeScript
- Python
- curl
const stocks = await get("/v1/gateway/assets?asset_class=stock");
stocks = get("/v1/gateway/assets?asset_class=stock")
curl -s -G https://api.truemarkets.co/v1/gateway/assets \
-d asset_class=stock
{
"data": [
{
"id": "d4f1a2b3-6c7e-4f80-9a1b-2c3d4e5f6a70",
"symbol": "AAPLC",
"chain": "base",
"asset_class": "stock",
"…": "…"
}
]
}
Fields that describe an asset
Four fields tell you what an asset is and where it trades.
| Field | Values | What it tells you |
|---|---|---|
venue | defi, cefi | where the asset trades |
asset_class | crypto, stock | a token, or a tokenized stock |
type | spot, perp | spot, or a perpetual future |
chain | a chain name | the network the asset settles on. Fund the wallet on that network. |