Skip to main content
GET
/
wrapped-assets
/
{wrapped_asset_id}
Get wrapped asset details
curl --request GET \
  --url https://api.exchange.coinbase.com/wrapped-assets/{wrapped_asset_id} \
  --header 'cb-access-key: <api-key>' \
  --header 'cb-access-passphrase: <api-key>' \
  --header 'cb-access-sign: <api-key>' \
  --header 'cb-access-timestamp: <api-key>'
{
  "id": "CBETH",
  "circulating_supply": "221127.7137774658",
  "total_supply": "926714.1251656958084",
  "conversion_rate": "1.006081377449935752",
  "apy": "0.0384",
  "redeem_time_estimate_days": "12.34"
}

​
Properties

​
Circulating Supply

The number of wrapped asset units in possession of customers. It excludes units pre-minted and held in abeyance to quickly serve wrapping customers. Circulating supply is the most appropriate input to determine the market capitalization of a wrapped asset.

​
Total Supply

The total number of wrapped asset units that have been minted and exist on-chain.

​
Conversion Rate

The number of underlying staked units that can be exchanged for 1 wrapped asset (e.g., the number of ETH2 units per 1 cbETH unit).

​
Implied APY

Current annualized percentage yield earned as the net rewards by the staked ETH underlying cbETH. This estimate is based on the past 7 days of staking performance and is updated daily. For more details, refer to the “rate calculation” section of the cbETH whitepaper.

​
Response

​
200 Success

A successful request responds with HTTP status code 200 (OK) and the JSON response body has the following form: 
{
  "circulating_supply": "288918.5085968099228762",
  "total_supply": "1021881.5038440099228762",
  "conversion_rate": "1.0213397911189787"
}

​
429 Failure

This endpoint can be queried at most once a second. If queried more than once a second, the failed request responds with HTTP status code 429 (Too Many Requests) and the JSON response body has the following form: 
{
  "message": "Public rate limit exceeded"
}
Coinbase recommends that you repeatedly query the API, sleeping 1 second in between queries, to get conversion rate updates (currently updated 1x a day) as soon as possible without exceeding the rate limit.

Authorizations

​
cb-access-key
string
header
required
​
cb-access-passphrase
string
header
required
​
cb-access-sign
string
header
required
​
cb-access-timestamp
string
header
required

Path Parameters

​
wrapped_asset_id
string
required

Response

​
id
string
required

The symbol of the wrapped asset

​
circulating_supply
string
required

The assets wrapped by customers less the assets unwrapped by customers existing outside of Coinbase's premint account

​
total_supply
string
required

The total token supply of the asset matching that on Etherscan

​
conversion_rate
string
required

The conversion rate between the wrapped asset and the underlying asset

​
apy
string
required

The APY earned by the supply of the underlying asset

​
redeem_time_estimate_days
string
required

The estimated time to redeem the wrapped asset in days