Assets
List the assets that have market prices.
# Assets
`GET https://api.rarebl.com/open/market/assets`
The assets with prices: symbol, name, chain, token contract and decimals.
**Rate class:** read (5 requests per second, burst 20, per IP). **Available since:** Open API v2.
## Request
Send the parameters as query parameters (GET) or as a JSON object (POST with `Content-Type: application/json`). They are identical either way. No API key is needed: `X-API-KEY` is reserved and ignored.
Example: `curl "https://api.rarebl.com/open/market/assets"`
## Parameters
This endpoint takes no parameters.
## Responses
### API200 (HTTP 200): OK
Assets (shortened).
```json
{
"status": 1,
"code": "API200",
"message": "success",
"data": {
"assets": [
{
"symbol": "BTC",
"name": "Bitcoin",
"chain": "btc",
"contract": null,
"decimals": 8
},
{
"symbol": "ETH",
"name": "Ether",
"chain": "eth",
"contract": null,
"decimals": 18
},
{
"symbol": "LTC",
"name": "Litecoin",
"chain": "ltc",
"contract": null,
"decimals": 8
},
{
"symbol": "TRX",
"name": "TRON",
"chain": "tron",
"contract": null,
"decimals": 6
},
{
"symbol": "USDC",
"name": "USD Coin (ERC-20)",
"chain": "eth",
"contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"decimals": 6
},
{
"symbol": "USDT",
"name": "Tether USD (ERC-20)",
"chain": "eth",
"contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"decimals": 6
},
{
"symbol": "USDT-TRON",
"name": "Tether USD (TRC-20)",
"chain": "tron",
"contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"decimals": 6
}
]
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
| Field | Type | Description |
| --- | --- | --- |
| `data.assets[]` | object[] | `{symbol, name, chain, contract \| null, decimals}`. |
### API429 (HTTP 429): Too Many Requests
Rate limited (read class: 5 requests per second, burst 20, per IP). A `Retry-After` header says how long to wait, in seconds.
```json
{
"status": 0,
"code": "API429",
"message": "Too many requests. Please retry shortly.",
"data": null,
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
## Notes
- Use it to map a token contract to a price symbol.