List assets

List assets supported by the platform.

GET /core/assets

List assets

cURL

curl --request GET \
  --url https://api.enterprise.sandbox.uphold.com/core/assets \
  --header 'Authorization: Bearer <token>'

200

Assets Retrieved

{
  "assets": [
    {
      "code": "GBP",
      "name": "British Pound",
      "type": "fiat",
      "symbol": "£",
      "decimals": 2,
      "logo": "https://cdn.uphold.com/assets/GBP.svg",
      "features": [
        "buy",
        "deposit",
        "sell",
        "transfer",
        "withdraw"
      ],
      "cooldowns": []
    },
    {
      "code": "BTC",
      "name": "Bitcoin",
      "type": "crypto",
      "symbol": "₿",
      "decimals": 8,
      "logo": "https://cdn.uphold.com/assets/BTC.svg",
      "features": [
        "buy",
        "deposit",
        "sell",
        "transfer",
        "withdraw"
      ],
      "cooldowns": []
    },
    {
      "code": "ETH",
      "name": "Ether",
      "type": "crypto",
      "symbol": "Ξ",
      "decimals": 18,
      "logo": "https://cdn.uphold.com/assets/ETH.svg",
      "features": [
        "buy",
        "deposit",
        "sell",
        "transfer",
        "withdraw"
      ],
      "cooldowns": []
    },
    {
      "code": "USDC",
      "name": "USDC",
      "type": "crypto",
      "symbol": "$",
      "decimals": 6,
      "logo": "https://cdn.uphold.com/assets/USDC.svg",
      "features": [
        "buy",
        "sell",
        "transfer"
      ],
      "cooldowns": []
    },
    {
      "code": "BAT",
      "name": "BAT",
      "type": "crypto",
      "decimals": 18,
      "logo": "https://cdn.uphold.com/assets/BAT.svg",
      "features": [
        "buy",
        "deposit",
        "sell",
        "transfer",
        "withdraw"
      ],
      "cooldowns": []
    }
  ]
}

If the subject calling the endpoint is a user, the response will be contextualized accordingly. As an example, the features field will indicate the available features for the user.

You can retrieve several assets in a single request by using the Get Many Assets endpoint.

Sorting

You can sort the assets by using the sort query parameter. Below are the available sorting options:

By name

To sort by name, use the sort=name:asc or sort=name:desc to sort in ascending or descending order, respectively.

By code

To sort by code, use the sort=code:asc or sort=code:desc to sort in ascending or descending order, respectively.

By price

To sort by current price, use the sort=price:asc or sort=price:desc to sort in ascending or descending order, respectively.

By price variance

The price-delta allows you to sort assets by gainers and losers, showing assets with the highest and lowest price changes in a given interval.

To sort by price delta, use the sort=price-delta:asc:<interval> or sort=price-delta:desc:<interval> to sort in ascending or descending order, respectively, where interval can be one-hour, one-day, one-week, one-month, one-year, or five-years.

By market cap

To sort by market cap, use the sort=market-cap:asc or sort=market-cap:desc to sort in ascending or descending order, respectively.

Authorizations

Authorization · string · header · required

OAuth 2.0 authentication.

Query Parameters

type · enum<string>[]

Filter assets by type.

Maximum array length: 25

The type of the asset.

Available options: fiat, crypto

sort · enum<string> · default: code:asc

Sort assets by a criterion.

Available options: code:asc, code:desc, name:asc, name:desc, price:asc, price:desc, price-delta:asc:one-hour, price-delta:asc:one-day, price-delta:asc:one-week, price-delta:asc:one-month, price-delta:asc:one-year, price-delta:asc:five-years, price-delta:desc:one-hour, price-delta:desc:one-day, price-delta:desc:one-week, price-delta:desc:one-month, price-delta:desc:one-year, price-delta:desc:five-years, market-cap:asc, market-cap:desc

Response

200 - application/json

Assets list retrieved.

assets · object[] · required

Show child attributes