List Assets Details

This endpoint will return a list of details on assets. These could be cryptocurrencies or FIAT assets that we support. Each asset has a unique identifier - assetId and a unique symbol in the form of a string, e.g. "BTC".

The details returned could include information on the latest rate and rate fluctuation of different periods of time - 24 hours, a week, one hour, the encoding of the logo, and more.

List of Results - This endpoint returns a list of data of the same type which means pagination is applicable. GET /market-data/assets/details

Query parameters

  • Optional
    context string

    In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

  • Optional
    assetType string

    Defines the type of the supported asset. This could be either "crypto" or "fiat".

    Example : crypto
    Possible Values : fiat crypto
  • Optional
    cryptoType string

    Subtype of the crypto assets. Could be COIN or TOKEN

    Example : coin
    Possible Values : coin token
  • Optional
    limit integer

    Defines how many items should be returned in the response per page basis.

    Default : 50
    Example : 50
  • Optional
    offset integer

    The starting index of the response items, i.e. where the response should start listing the returned items.

    Default : 0
    Example : 10
  • Optional
    waasEnabled boolean

    Show only if WaaS is/not enabled

    Example : True

Response schema

200 400 401 402 403 409 415 422 429 500
HTTP Status Code: 200
Content-Type: application/json

The request has been successful.

  • Object :

  • Required
    apiVersion string

    Specifies the version of the API that incorporates this endpoint.

    Example : 2.0
  • Required
    requestId string

    Defines the ID of the request. The requestId is generated by Crypto APIs and it's unique for every request.

    Example : 601c1710034ed6d407996b30
  • Optional
    context string

    In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

    Example : You can add any text here
  • Required
    data object
    • Required
      offset integer

      The starting index of the response items, i.e. where the response should start listing the returned items.

      Example : 0
    • Required
      limit integer

      Defines how many items should be returned in the response per page basis.

      Example : 50
    • Required
      total integer

      Defines the total number of items returned in the response.

      Example : 100
    • Required
      items array
      Example : Array ( )
      • Required
        assetId string

        Defines the unique ID of the specific asset.

        Example : 5b1ea92e584bf50020130615
      • Required
        assetLogo object

        Defines the logo of the asset.

        • Required
          encoding string

          Defines the encoding of the image data which is usually base64.

          Example : base64
        • Required
          imageData string

          Defines the encoded image data as a string.

          Example : PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIzMiIgaGVpZ2h0PSIzMiI+PGcgZmlsbD0ibm9uZSIgZmlsbC1ydWxlPSJldmVub2RkIj48Y2lyY2xlIGN4PSIxNiIgY3k9IjE2IiByPSIxNiIgZmlsbD0iIzYyN0VFQSIvPjxnIGZpbGw9IiNGRkYiIGZpbGwtcnVsZT0ibm9uemVybyI+PHBhdGggZmlsbC1vcGFjaXR5PSIuNjAyIiBkPSJNMTYuNDk4IDR2OC44N2w3LjQ5NyAzLjM1eiIvPjxwYXRoIGQ9Ik0xNi40OTggNEw5IDE2LjIybDcuNDk4LTMuMzV6Ii8+PHBhdGggZmlsbC1vcGFjaXR5PSIuNjAyIiBkPSJNMTYuNDk4IDIxLjk2OHY2LjAyN0wyNCAxNy42MTZ6Ii8+PHBhdGggZD0iTTE2LjQ5OCAyNy45OTV2LTYuMDI4TDkgMTcuNjE2eiIvPjxwYXRoIGZpbGwtb3BhY2l0eT0iLjIiIGQ9Ik0xNi40OTggMjAuNTczbDcuNDk3LTQuMzUzLTcuNDk3LTMuMzQ4eiIvPjxwYXRoIGZpbGwtb3BhY2l0eT0iLjYwMiIgZD0iTTkgMTYuMjJsNy40OTggNC4zNTN2LTcuNzAxeiIvPjwvZz48L2c+PC9zdmc+
        • Required
          mimeType string

          Defines the image type of the logo - jpg, png, svg, etc.

          Example : "image/svg+xml"
      • Required
        assetName string

        Specifies the name of the asset in question.

        Example : Bitcoin
      • Required
        assetOriginalSymbol string

        Specifies the asset's original symbol as introduced by its founders.

        Example : BTC
      • Required
        assetSymbol string

        Specifies the asset's unique symbol in the Crypto APIs listings.

        Example : BTC
      • Required
        assetType string

        Defines the type of the supported asset. This could be either "crypto" or "fiat".

        Example : crypto
        Possible Values : fiat crypto
      • Required
        latestRate object

        Specifies the latest price of the asset.

        • Required
          amount string

          Specifies the amount of the latest price of the asset.

          Example : 55249.960371879235
        • Optional
          calculationTimestamp integer

          Defines when the price was calculated in UNIX timestamp.

          Example : 1618843796
        • Required
          unit string

          Specifies the unit of the latest price of the asset.

          Example : USD
      • Optional
        slug string

        Asset`s unique slug string in Crypto APIs listings

        Example : tether
      • Required
        specificData object One Of
        object
        • Required
          1HourPriceChangeInPercentage string

          Represents the percentage of the asset's current price against the its price from 1 hour ago.

          Example : -2.52
        • Required
          1WeekPriceChangeInPercentage string

          Represents the percentage of the asset's current price against the its price from 1 week ago.

          Example : -10.18
        • Required
          24HoursPriceChangeInPercentage string

          Represents the percentage of the asset's current price against the its price from 24 hours ago.

          Example : -3.37
        • Required
          24HoursTradingVolume string

          Represents the trading volume of the asset for the time frame of 24 hours.

          Example : 2871630447
        • Required
          assetType string

          Subtype of the crypto assets. Could be COIN or TOKEN

          Example : coin
          Possible Values : coin token
        • Required
          circulatingSupply string

          Represents the amount of the asset that is circulating on the market and in public hands.

          Example : 123564.25
        • Required
          marketCapInUSD string

          Defines the total market value of the asset's circulating supply in USD.

          Example : 10198150322.917389
        • Required
          maxSupply string

          Represents the maximum amount of all coins of a specific asset that will ever exist in its lifetime.

          Example : 21000000

Credits Cost : 1 Credits For 1 Result(s)

Try it out

Request Example

GET
https://rest.cryptoapis.io/v2/market-data/assets/details?assetType=crypto&cryptoType=coin&limit=50&offset=10&waasEnabled=1
Headers
Host: https://rest.cryptoapis.io/v2
Content-Type: application/json
X-API-Key: my-api-key

Response Example

{
    "apiVersion": "2.0",
    "requestId": "601c1710034ed6d407996b30",
    "context": "You can add any text here",
    "data": {
        "offset": 0,
        "limit": 50,
        "total": 100,
        "items": [
            {
                "assetId": "5b1ea92e584bf50020130615",
                "assetLogo": {
                    "encoding": "base64",
                    "imageData": "PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIzMiIgaGVpZ2h0PSIzMiI+PGcgZmlsbD0ibm9uZSIgZmlsbC1ydWxlPSJldmVub2RkIj48Y2lyY2xlIGN4PSIxNiIgY3k9IjE2IiByPSIxNiIgZmlsbD0iIzYyN0VFQSIvPjxnIGZpbGw9IiNGRkYiIGZpbGwtcnVsZT0ibm9uemVybyI+PHBhdGggZmlsbC1vcGFjaXR5PSIuNjAyIiBkPSJNMTYuNDk4IDR2OC44N2w3LjQ5NyAzLjM1eiIvPjxwYXRoIGQ9Ik0xNi40OTggNEw5IDE2LjIybDcuNDk4LTMuMzV6Ii8+PHBhdGggZmlsbC1vcGFjaXR5PSIuNjAyIiBkPSJNMTYuNDk4IDIxLjk2OHY2LjAyN0wyNCAxNy42MTZ6Ii8+PHBhdGggZD0iTTE2LjQ5OCAyNy45OTV2LTYuMDI4TDkgMTcuNjE2eiIvPjxwYXRoIGZpbGwtb3BhY2l0eT0iLjIiIGQ9Ik0xNi40OTggMjAuNTczbDcuNDk3LTQuMzUzLTcuNDk3LTMuMzQ4eiIvPjxwYXRoIGZpbGwtb3BhY2l0eT0iLjYwMiIgZD0iTTkgMTYuMjJsNy40OTggNC4zNTN2LTcuNzAxeiIvPjwvZz48L2c+PC9zdmc+",
                    "mimeType": "\"image/svg+xml\""
                },
                "assetName": "Bitcoin",
                "assetOriginalSymbol": "BTC",
                "assetSymbol": "BTC",
                "assetType": "crypto",
                "latestRate": {
                    "amount": "55249.960371879235",
                    "calculationTimestamp": 1618843796,
                    "unit": "USD"
                },
                "slug": "tether",
                "specificData": {
                    "1HourPriceChangeInPercentage": "-2.52",
                    "1WeekPriceChangeInPercentage": "-10.18",
                    "24HoursPriceChangeInPercentage": "-3.37",
                    "24HoursTradingVolume": "2871630447",
                    "assetType": "coin",
                    "circulatingSupply": "123564.25",
                    "marketCapInUSD": "10198150322.917389",
                    "maxSupply": "21000000"
                }
            }
        ]
    }
}