---
title: "Get Asset by Symbol"
method: GET
path: "/v1/assets/{symbol}"
tags: ["asset-data"]
---

# Get Asset by Symbol

`GET /v1/assets/{symbol}`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v1/assets/{symbol}`
- Auth: none required
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/assets/:symbol/get.ts> (a function with typed inputs; its response is checked against the schema)

Get Asset by Symbol

## Path parameters

- `symbol` string, required

## Response `200`

OK

- Asset
  - `assetId` string, required: unique asset ID
  - `symbol` string, required: asset symbol as denoted in the world
  - `name` string, required: asset name
  - `precision` string, required: number of decimal digits 'after the dot' for asset amount
  - `minBalanceInterest` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `minFee` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `apr` string, required: annualized percentage rate
  - `collateralRating` string, required: collateral rating applied to this asset, a value of 100.00 indicates 100%. `Deprecated in favour of collateral bands`
  - `maxBorrow` string, required: maximum quantity that can be borrowed for this asset
  - `totalOfferedLoanQuantity` string, required: quantity of an asset that is across all loan offers on the exchange
  - `loanBorrowedQuantity` string, required: amount of loans that is currently being borrowed for the asset
  - `collateralBands` CollateralBand[], required: list of collateral bands for the asset. A collateral band holds the upper limit of the USD notional and the corresponding collateral percentage which applies to it. An asset's collateral value will be capped by the highest limit of the collateral bands, any remaining amount greater than this limit will have a collateral percentage of 0. If an asset has an empty list of CollateralBands, this signifies that the asset has a collateralValue of 0.
    - `collateralPercentage` string: collateral percentage applied to the asset for this band - a value of 90.00 indicates 90% of the asset is eligible to be used as collateral
    - `bandLimitUSD` string: upper limit in USD for this band
  - `underlyingAsset` UnderlyingAsset, required
    - `symbol` string: underlying asset symbol
    - `assetId` string: underlying asset ID
    - `bpmMinReturnStart` string: start of the 1/1000 biggest downward price movement of an underlying asset over 6 hours
    - `bpmMinReturnEnd` string: end of the 1/1000 biggest downward price movement of an underlying asset over 6 hours
    - `bpmMaxReturnStart` string: start of the 1/1000 biggest upward price movement of an underlying asset over 6 hours
    - `bpmMaxReturnEnd` string: end of the 1/1000 biggest upward price movement of an underlying asset over 6 hours
    - `marketRiskFloorPctStart` string: the percentage range of risk reduction allowed for a portfolio
    - `marketRiskFloorPctEnd` string: the percentage range of risk reduction allowed for a portfolio
    - `bpmTransitionDateTimeStart` string: the start datetime which the values linearly transition from `bpmMinReturnStart` to `bpmMinReturnEnd` for an underlying asset
    - `bpmTransitionDateTimeEnd` string: the end datetime which the values linearly transition from `bpmMinReturnStart` to `bpmMinReturnEnd` for an underlying asset

## Other responses

- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)