github.com/diadata-org/diadata@v1.4.593/documentation/api-1/api-endpoints.md (about)

     1  ---
     2  description: >-
     3    The DIA base url is https://api.diadata.org. All API paths are sub-paths of
     4    this base URL.
     5  ---
     6  
     7  # API Endpoints
     8  
     9  ## Digital Assets
    10  
    11  ### Coins data
    12  
    13  {% swagger method="get" path="v1/assetQuotation/:blockchain/:asset" baseUrl="https://api.diadata.org/" summary="Asset Quotation" %}
    14  {% swagger-description %}
    15  Returns the quotation for a fully qualified asset (i.e. distinguished by blockchain and address).
    16  
    17  _Example:_ [_https://api.diadata.org/v1/assetQuotation/Bitcoin/0x0000000000000000000000000000000000000000_](https://api.diadata.org/v1/assetQuotation/Bitcoin/0x0000000000000000000000000000000000000000)__
    18  {% endswagger-description %}
    19  
    20  {% swagger-parameter in="path" name="blockchain" required="true" %}
    21  Name of the blockchain for requested asset
    22  {% endswagger-parameter %}
    23  
    24  {% swagger-parameter in="path" name="asset" required="true" %}
    25  Address of the requested asset
    26  {% endswagger-parameter %}
    27  
    28  {% swagger-response status="200: OK" description="Return of asset price action information" %}
    29  ```javascript
    30  {
    31      // Response
    32  }
    33  ```
    34  {% endswagger-response %}
    35  {% endswagger %}
    36  
    37  {% swagger baseUrl="https://api.diadata.org" path="/v1/assetChartPoints/:filter/:blockchain/:address" method="get" summary="Asset Chart Points" %}
    38  {% swagger-description %}
    39  Get asset details for all exchanges.
    40  
    41  _Example_:\
    42  [https://api.diadata.org/v1/assetChartPoints/MA120/Bitcoin/0x0000000000000000000000000000000000000000](https://api.diadata.org/v1/assetChartPoints/MA120/Bitcoin/0x0000000000000000000000000000000000000000)
    43  
    44  \
    45  _Remark:_ Careful! Successful responses can be rather large.
    46  {% endswagger-description %}
    47  
    48  {% swagger-parameter in="path" name="filter" type="string" required="true" %}
    49  Which filter should be applied (Available options: MA120, MEDIR120, VOL120 and MAIR120).
    50  {% endswagger-parameter %}
    51  
    52  {% swagger-parameter in="path" name="blockchain" type="string" required="true" %}
    53  A valid blockchain from GET /v1/blockchains, e.g., Bitcoin.
    54  {% endswagger-parameter %}
    55  
    56  {% swagger-parameter in="path" name="address" required="true" %}
    57  A valid asset address from GET /v1/token/:symbol, e.g., 0x000000000000000000000000000000000000000 for BTC.
    58  {% endswagger-parameter %}
    59  
    60  {% swagger-parameter in="path" name="starttime" type="integer" %}
    61  Unix timestamp setting the start of the return array
    62  {% endswagger-parameter %}
    63  
    64  {% swagger-parameter in="path" name="endtime" type="integer" %}
    65  Unix timestamp setting the end of the return array
    66  {% endswagger-parameter %}
    67  
    68  {% swagger-parameter in="query" name="scale" type="string" %}
    69  Which scale the graph points distance should have. Available options: 5m 30m 1h 4h 1d 1w
    70  {% endswagger-parameter %}
    71  
    72  {% swagger-response status="200" description="Successful retrieval of a chart points for an asset" %}
    73  ```
    74  {"DataPoints":[{"Series":[{"name":"filters","columns":["time","exchange","filter","symbol","value"],"values":[["2020-05-19T08:17:59Z",null,"MEDIR120","EOS",2.6236194301032314]]}],"Messages":null}]}
    75  ```
    76  {% endswagger-response %}
    77  {% endswagger %}
    78  
    79  {% swagger method="get" path="/v1/lastTradesAsset/:blockchain/:address" baseUrl="https://api.diadata.org" summary="Asset Last Trades" %}
    80  {% swagger-description %}
    81  Get last trades for an asset.
    82  
    83  _Example:_ [https://api.diadata.org/v1/lastTradesAsset/Bitcoin/0x0000000000000000000000000000000000000000](https://api.diadata.org/v1/lastTradesAsset/Bitcoin/0x0000000000000000000000000000000000000000)
    84  {% endswagger-description %}
    85  
    86  {% swagger-parameter in="path" name="blockchain" required="true" %}
    87  A valid blockchain from GET /v1/blockchains, e.g., Bitcoin.
    88  {% endswagger-parameter %}
    89  
    90  {% swagger-parameter in="path" name="address" required="true" %}
    91  A valid asset address from GET /v1/token/:symbol, e.g., 0x000000000000000000000000000000000000000 for BTC.
    92  {% endswagger-parameter %}
    93  
    94  {% swagger-response status="200: OK" description="Succesful retrieval of last trades for an asset" %}
    95  ```javascript
    96  {
    97      // Response
    98  }
    99  ```
   100  {% endswagger-response %}
   101  {% endswagger %}
   102  
   103  {% swagger method="get" path="/v1/assetSupply/Ethereum/:address" baseUrl="https://api.diadata.org" summary="Asset Supply" %}
   104  {% swagger-description %}
   105  Get circulating and total supply for an asset.
   106  
   107  _Example:_ [https://api.diadata.org/v1/assetSupply/Ethereum/0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9](https://api.diadata.org/v1/assetSupply/Ethereum/0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9)
   108  
   109  _Note: Currently supports assets only from Ethereum blockchain_
   110  {% endswagger-description %}
   111  
   112  {% swagger-parameter in="path" name="address" %}
   113  A valid asset address from GET /v1/token/:symbol, e.g., 0x000000000000000000000000000000000000000 for BTC.
   114  {% endswagger-parameter %}
   115  {% endswagger %}
   116  
   117  {% swagger method="get" path="/v1/blockchains" baseUrl="https://api.diadata.org" summary="Blockchains" %}
   118  {% swagger-description %}
   119  Get a list of all available blockchains.
   120  {% endswagger-description %}
   121  
   122  {% swagger-response status="200: OK" description="" %}
   123  ```javascript
   124  {
   125      // Response
   126  }
   127  ```
   128  {% endswagger-response %}
   129  {% endswagger %}
   130  
   131  {% swagger baseUrl="https://api.diadata.org" path="/v1/exchanges" method="get" summary="Exchanges" %}
   132  {% swagger-description %}
   133  Get a list of all available crypto exchanges.
   134  {% endswagger-description %}
   135  
   136  {% swagger-response status="200" description="Successful retrieval of available exchanges." %}
   137  ```
   138  ["KuCoin","Uniswap","Balancer","Maker","Gnosis","Curvefi","Binance","BitBay","Bitfinex","Bittrex","CoinBase","GateIO","HitBTC","Huobi","Kraken","LBank","OKEx","Quoine","Simex","ZB","Bancor","Loopring","SushiSwap","Dforce","0x","Kyber","Bitmax","PanCakeSwap","CREX24","STEX"]
   139  ```
   140  {% endswagger-response %}
   141  {% endswagger %}
   142  
   143  {% swagger baseUrl="https://api.diadata.org" path="/v1/symbols" method="get" summary="Symbols" %}
   144  {% swagger-description %}
   145  Get a list of all available symbols for cryptocurrencies.\
   146  \
   147  Get symbols restricted to an exchange using the query parameter. (For the moment only for centralized exchanges).
   148  
   149  _Example_: [https://api.diadata.org/v1/symbols?exchange=Kraken](https://api.diadata.org/v1/symbols?exchange=Kraken)\
   150  
   151  {% endswagger-description %}
   152  
   153  {% swagger-parameter in="query" name="exchange" type="string" %}
   154  Name of the crypto exchange.
   155  {% endswagger-parameter %}
   156  
   157  {% swagger-parameter in="path" name="substring" %}
   158  Search for coins that match a string, e.g. 
   159  
   160  _BTC_
   161  
   162   will return BTC, BTCB and other assets that start with 
   163  
   164  _BTC_
   165  
   166   letters.
   167  {% endswagger-parameter %}
   168  
   169  {% swagger-response status="200" description="Successful retrieval of available symbols for cryptocurrencies. Shown below is an exerpt of the full response." %}
   170  ```
   171  {"Symbols":["EOS","QTUM","BCH","BFT","FLDC","NXS","BLOCK","GAM","GLD","LOOM",...
   172  ```
   173  {% endswagger-response %}
   174  {% endswagger %}
   175  
   176  {% swagger baseUrl="https://api.diadata.org" path="/v1/quotation/:symbol" method="get" summary="Quotation" %}
   177  {% swagger-description %}
   178  Get most recent information on the currency corresponding to symbol.
   179  
   180  _Example_: [https://api.diadata.org/v1/quotation/BTC](https://api.diadata.org/v1/quotation/BTC)
   181  {% endswagger-description %}
   182  
   183  {% swagger-parameter in="path" name="symbol" type="string" %}
   184  Which symbol to get a quotation for, e.g., BTC.
   185  {% endswagger-parameter %}
   186  
   187  {% swagger-response status="200" description="Successful retrieval of the BTC symbol." %}
   188  ```
   189  {"Symbol":"BTC","Name":"Bitcoin","Price":9777.19339776667,"PriceYesterday":9574.416265039981,"VolumeYesterdayUSD":298134760.8811487,"Source":"diadata.org","Time":"2020-05-19T08:41:12.499645584Z","ITIN":"DXVPYDQC3"}
   190  ```
   191  {% endswagger-response %}
   192  {% endswagger %}
   193  
   194  {% swagger method="get" path="/v1/token/:symbol" baseUrl="https://api.diadata.org" summary="Tokens list" %}
   195  {% swagger-description %}
   196  Get a list of blockchains and addresses for all tokens that match the symbol
   197  {% endswagger-description %}
   198  
   199  {% swagger-parameter in="path" name="symbol" required="true" %}
   200  Which symbol to get a quotation for, e.g., BTC.
   201  {% endswagger-parameter %}
   202  
   203  {% swagger-response status="200: OK" description="" %}
   204  ```javascript
   205  {
   206      // Response
   207  }
   208  ```
   209  {% endswagger-response %}
   210  {% endswagger %}
   211  
   212  {% swagger baseUrl="https://api.diadata.org" path="/v1/chartPoints/:filter/:exchange/:symbol" method="get" summary="Exchange Chart Points" %}
   213  {% swagger-description %}
   214  Get chart points for an exchange.
   215  
   216  _Example_: [https://api.diadata.org/v1/chartPoints/MEDIR120/Binance/BTC](https://api.diadata.org/v1/chartPoints/MEDIR120/Binance/BTC)\
   217  \
   218  _Note_: Successful responses can be rather large.
   219  {% endswagger-description %}
   220  
   221  {% swagger-parameter in="path" name="filter" type="string" required="true" %}
   222  Which filter should be applied (Available options: MA120, VOL120, MEDIR120 and MAIR120).
   223  {% endswagger-parameter %}
   224  
   225  {% swagger-parameter in="path" name="exchange" type="string" required="true" %}
   226  A valid exchange from GET /v1/exchanges, e.g., Binance
   227  {% endswagger-parameter %}
   228  
   229  {% swagger-parameter in="path" name="symbol" type="string" required="true" %}
   230  A valid symbol from GET /v1/coins, e.g., BTC.
   231  {% endswagger-parameter %}
   232  
   233  {% swagger-parameter in="query" name="scale" type="string" %}
   234  Which scale the graph points distance should have. Available options: 5m 30m 1h 4h 1d 1w.
   235  {% endswagger-parameter %}
   236  
   237  {% swagger-response status="200" description="Successful retrieval of a chart point." %}
   238  ```
   239  {"DataPoints":[{"Series":[{"name":"filters","columns":["time","exchange","filter","symbol","value"],"values":[["2020-05-19T08:02:09Z","GateIO","MEDIR120","EOS",2.6218717017500084]]}],"Messages":null}]}
   240  ```
   241  {% endswagger-response %}
   242  {% endswagger %}
   243  
   244  {% swagger baseUrl="https://api.diadata.org" path="/v1/supply/:symbol" method="get" summary="Supply" %}
   245  {% swagger-description %}
   246  Get the current circulating supply for the token corresponding to symbol.
   247  
   248  _Example_: [https://api.diadata.org/v1/supply/BTC](https://api.diadata.org/v1/supply/BTC)
   249  {% endswagger-description %}
   250  
   251  {% swagger-parameter in="path" name="symbol" type="string" required="true" %}
   252  Which symbol to get the supply for, e.g., BTC
   253  {% endswagger-parameter %}
   254  
   255  {% swagger-response status="200" description="Successful retrieval of BTC supply." %}
   256  ```
   257  {"Symbol":"BTC","Name":"Bitcoin","CirculatingSupply":17655550,"Source":"diadata.org","Time":"2019-04-20T08:44:25.748170404Z","Block":0}
   258  ```
   259  {% endswagger-response %}
   260  {% endswagger %}
   261  
   262  {% swagger baseUrl="https://api.diadata.org" path="/v1/supplies/:symbol" method="get" summary="Supplies" %}
   263  {% swagger-description %}
   264  Get all recorded supply values for the token corresponding to symbol.
   265  
   266  _Example_: [https://api.diadata.org/v1/supplies/BTC](https://api.diadata.org/v1/supplies/BTC)\
   267  \
   268  Get supply values for a time range using the query parameters.
   269  
   270  _Example_: [https://api.diadata.org/v1/supplies/BTC?starttime=1647349656\&endtime=1650028056](https://api.diadata.org/v1/supplies/BTC?starttime=1647349656\&endtime=1650028056)\
   271  
   272  {% endswagger-description %}
   273  
   274  {% swagger-parameter in="path" name="symbol" type="string" required="true" %}
   275  Which symbol to get the supply fot, e.g., BTC
   276  {% endswagger-parameter %}
   277  
   278  {% swagger-parameter in="query" name="starttime" type="integer" %}
   279  Unix timestamp setting the start of the return array
   280  {% endswagger-parameter %}
   281  
   282  {% swagger-parameter in="query" name="endtime" type="integer" %}
   283  Unix timestamp setting the end of the return array
   284  {% endswagger-parameter %}
   285  
   286  {% swagger-response status="200" description="Successful retrieval of two supply values for Bitcoin (BTC) between timestamps 1591700000 and 1591883936." %}
   287  ```
   288  [{"Symbol":"BTC","Name":"Bitcoin","CirculatingSupply":18399687,"Source":"diadata.org","Time":"2020-06-09T23:59:59Z","Block":0},{"Symbol":"BTC","Name":"Bitcoin","CirculatingSupply":18400712,"Source":"diadata.org","Time":"2020-06-10T23:59:59Z","Block":0}]
   289  ```
   290  {% endswagger-response %}
   291  {% endswagger %}
   292  
   293  {% swagger baseUrl="https://api.diadata.org" path="/v1/foreignSymbols/:source" method="get" summary="Guest Symbols" %}
   294  {% swagger-description %}
   295  Get the list of available symbols along with their ITIN for guest quotations.
   296  
   297  _Example_: [https://api.diadata.org/v1/foreignSymbols/Coingecko](https://api.diadata.org/v1/foreignSymbols/Coingecko)
   298  {% endswagger-description %}
   299  
   300  {% swagger-parameter in="path" name="source" type="string" required="true" %}
   301  source of the quotation
   302  {% endswagger-parameter %}
   303  
   304  {% swagger-response status="200" description="" %}
   305  ```
   306  ```
   307  {% endswagger-response %}
   308  {% endswagger %}
   309  
   310  {% swagger baseUrl="https://api.diadata.org" path="/v1/foreignQuotation/:source/:symbol" method="get" summary="Guest Quotation" %}
   311  {% swagger-description %}
   312  Get the latest quotation for a token from a guest source.
   313  
   314  _Example_: [https://api.diadata.org/v1/foreignQuotation/CoinMarketCap/BTC](https://api.diadata.org/v1/foreignQuotation/CoinMarketCap/BTC)\
   315  \
   316  Use the query parameter time in order to get the latest quotation before the specified timestamp
   317  
   318  \
   319  _Example_: [https://api.diadata.org/v1/foreignQuotation/Coingecko/BTC?time=1647349656](https://api.diadata.org/v1/foreignQuotation/Coingecko/BTC?time=1647349656)\
   320  \
   321  \
   322  
   323  {% endswagger-description %}
   324  
   325  {% swagger-parameter in="path" name="source" type="string" required="true" %}
   326  source of the quotation
   327  {% endswagger-parameter %}
   328  
   329  {% swagger-parameter in="path" name="symbol" type="string" required="true" %}
   330  Which symbol to get a quotation for, e.g. BTC
   331  {% endswagger-parameter %}
   332  
   333  {% swagger-parameter in="query" name="time" type="number" %}
   334  Unix timestamp.
   335  {% endswagger-parameter %}
   336  
   337  {% swagger-response status="200" description="" %}
   338  ```
   339  ```
   340  {% endswagger-response %}
   341  {% endswagger %}
   342  
   343  {% swagger method="get" path="/v1/poolLiquidity/:blockchain/:address" baseUrl="https://api.diadata.org" summary="Pool Liquidity" %}
   344  {% swagger-description %}
   345  Get the latest liquidity for a pool on a decentralised exchange (DEX).
   346  
   347  _Example:_\
   348  [https://api.diadata.org/v1/poolLiquidity/Ethereum/0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc](https://api.diadata.org/v1/poolLiquidity/Ethereum/0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc)
   349  {% endswagger-description %}
   350  
   351  {% swagger-parameter in="path" name="blockchain" type="String" required="true" %}
   352  Name of the blockchain the requested pool lives on.
   353  {% endswagger-parameter %}
   354  
   355  {% swagger-parameter in="path" name="address" type="String" %}
   356  Address of the given pool.
   357  {% endswagger-parameter %}
   358  {% endswagger %}
   359  
   360  ### NFT data
   361  
   362  {% swagger method="get" path="/v1/NFTFloor/:blockchain/:address" baseUrl="https://api.diadata.org" summary="NFT Floor Price" %}
   363  {% swagger-description %}
   364  Returns the current floor price of a collection given by a blockchain and an address.\
   365  The floor price is derived from all sales in the last 24h.\
   366  _Example:_ [https://api.diadata.org/v1/NFTFloor/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB](https://api.diadata.org/v1/NFTFloor/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB)\
   367  \
   368  Use the query parameter timestamp in order to get the latest floor price before the specified timestamp.\
   369  _Example:_ [https://api.diadata.org/v1/NFTFloor/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?timestamp=1649342430](https://api.diadata.org/v1/NFTFloor/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?timestamp=1649342430)
   370  
   371  Use the query parameter floorWindow in order to get the floor price with respect to all sales in the last floorWindow seconds. Default value is 86400s=24h.\
   372  _Example:_ [https://api.diadata.org/v1/NFTFloor/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?floorWindow=43200](https://api.diadata.org/v1/NFTFloor/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?floorWindow=43200)
   373  {% endswagger-description %}
   374  
   375  {% swagger-parameter in="path" name="blockchain" type="String" required="true" %}
   376  Blockchain name
   377  {% endswagger-parameter %}
   378  
   379  {% swagger-parameter in="path" name="address" type="String" required="true" %}
   380  Address of the collection
   381  {% endswagger-parameter %}
   382  
   383  {% swagger-parameter in="query" name="timestamp" type="Integer" %}
   384  Unix timestamp
   385  {% endswagger-parameter %}
   386  
   387  {% swagger-parameter in="query" name="floorWindow" type="Integer" %}
   388  Number of seconds in considered interval
   389  {% endswagger-parameter %}
   390  
   391  {% swagger-response status="200: OK" description="Successful retrieval of a collection's floor price." %}
   392  ```javascript
   393  {"Floor_Price":74.8,"Time":"2022-06-07T14:34:35.024280719Z","Source":"diadata.org"}
   394  ```
   395  {% endswagger-response %}
   396  {% endswagger %}
   397  
   398  {% swagger method="get" path="/v1/NFTFloorMA/:blockchain/:address" baseUrl="https://api.diadata.org" summary="NFT Moving Average of Floor Price" %}
   399  {% swagger-description %}
   400  Returns the moving average of a collection's floor price over the past 30 days.\
   401  _Example:_ [https://api.diadata.org/v1/NFTFloorMA/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB](https://api.diadata.org/v1/NFTFloorMA/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB)
   402  
   403  Use the query parameter floorWindow in order to get the floor price with respect to all sales in the last floorWindow seconds. Default value is 86400s=24h.\
   404  _Example:_ [https://api.diadata.org/v1/NFTFloorMA/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?floorWindow=43200](https://api.diadata.org/v1/NFTFloorMA/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?floorWindow=43200)
   405  
   406  Use the query parameter lookbackSeconds in order to get the moving average over the last lookbackSeconds. Default value is 2592000s=30d.\
   407  _Example:_ [https://api.diadata.org/v1/NFTFloorMA/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?lookbackWindow=5184000](https://api.diadata.org/v1/NFTFloorMA/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?lookbackWindow=5184000)
   408  {% endswagger-description %}
   409  
   410  {% swagger-parameter in="path" required="true" name="blockchain" type="String" %}
   411  Blockchain name
   412  {% endswagger-parameter %}
   413  
   414  {% swagger-parameter in="path" name="address" type="String" required="true" %}
   415  Address of the collection
   416  {% endswagger-parameter %}
   417  
   418  {% swagger-parameter in="query" name="floorWindow" type="Integer" %}
   419  Number of seconds in considered  interval regarding floor price.
   420  {% endswagger-parameter %}
   421  
   422  {% swagger-parameter in="query" name="lookbackSeconds" type="Integer" %}
   423  Number of seconds in considered interval regarding moving average.
   424  {% endswagger-parameter %}
   425  
   426  {% swagger-response status="200: OK" description="Successful retrieval of a collection's moving average floor price" %}
   427  ```javascript
   428  {"Moving_Average_Floor_Price":49.653703703703705,"Time":"2022-06-07T14:48:14.647819158Z","Source":"diadata.org"}
   429  }
   430  ```
   431  {% endswagger-response %}
   432  {% endswagger %}
   433  
   434  {% swagger method="get" path="/v1/NFTDownday/:blockchain/:address" baseUrl="https://api.diadata.org" summary="NFT Max Weekly Drawdown and related Statistics" %}
   435  {% swagger-description %}
   436  Returns the maximal weekly drawdown in the last 90 days in percent.\
   437  Furthermore, the average and standard deviation of the weekly drawdown time-series is returned.\
   438  _Example:_ [https://api.diadata.org/v1/NFTDownday/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB](https://api.diadata.org/v1/NFTDownday/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB)
   439  
   440  Use the query parameter floorWindow in order to get the floor price with respect to all sales in the last floorWindow seconds. Default value is 86400s=24h.\
   441  _Example:_ [https://api.diadata.org/v1/NFTDownday/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?floorWindow=43200](https://api.diadata.org/v1/NFTDownday/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?floorWindow=43200)
   442  
   443  Use the query parameter lookbackSeconds in order to get the moving average over the last lookbackSeconds. Default value is 7776000s=90d.\
   444  _Example:_ [https://api.diadata.org/v1/NFTDownday/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?lookbackWindow=2592000](https://api.diadata.org/v1/NFTDownday/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?lookbackWindow=2592000)
   445  {% endswagger-description %}
   446  
   447  {% swagger-parameter in="path" name="blockchain" type="String" required="true" %}
   448  Blockchain name
   449  {% endswagger-parameter %}
   450  
   451  {% swagger-parameter in="path" name="address" type="String" %}
   452  Address of the collection
   453  {% endswagger-parameter %}
   454  
   455  {% swagger-parameter in="query" name="floorWindow" type="Integer" %}
   456  Number of seconds in considered  interval regarding floor price.
   457  {% endswagger-parameter %}
   458  
   459  {% swagger-parameter in="query" name="lookbackSeconds" type="Integer" %}
   460  Number of seconds in considered interval regarding weekly drawdown.
   461  {% endswagger-parameter %}
   462  
   463  {% swagger-response status="200: OK" description="Succesful retrieval of a collection's weekly drawdown stats." %}
   464  ```javascript
   465  {"Weekly_Drawdown":-18.303800719054955,"Downday_Average":-7.5472418447635405,"Downday_Deviation":11.362194930411123,"Time":"2022-06-07T15:04:08.093662489Z","Source":"diadata.org"}
   466  ```
   467  {% endswagger-response %}
   468  {% endswagger %}
   469  
   470  {% swagger method="get" path="/v1/NFTVolatility/:blockchain/:address" baseUrl="https://api.diadata.org" summary="NFT Volatility of Floor Price" %}
   471  {% swagger-description %}
   472  Returns the average and volatility of the floor price in the last 90 days.\
   473  _Example:_ [https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D](https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D)
   474  
   475  Use the parameter time in order to get the floor price at a previous time.\
   476  _Example:_ [https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?time=1655027598](https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?time=1655027598)
   477  
   478  Use the query parameter floorWindow in order to get the floor price with respect to all sales in the last floorWindow seconds. Default value is 86400s=24h.\
   479  _Example:_[ __ ](https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?time=1655027598) [https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?floorWindow=43200](https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?time=1655027598)
   480  
   481  Use the query parameter lookbackSeconds in order to get the moving average over the last lookbackSeconds. Default value is 7776000s=90d.\
   482  _Example:_  [https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?lookbackSeconds=25920000](https://api.diadata.org/v1/NFTVolatility/Ethereum/0xbC4CA0EdA7647A8aB7C2061c2E118A18a936f13D?time=1655027598)
   483  {% endswagger-description %}
   484  
   485  {% swagger-parameter in="path" name="blockchain" type="String" required="true" %}
   486  Blockchain name
   487  {% endswagger-parameter %}
   488  
   489  {% swagger-parameter in="path" name="address" type="String" required="true" %}
   490  Address of the collection
   491  {% endswagger-parameter %}
   492  
   493  {% swagger-parameter in="query" name="time" type="Integer" %}
   494  Unix timestamp (in seconds) of the volatility.
   495  {% endswagger-parameter %}
   496  
   497  {% swagger-parameter in="query" name="floorWindow" type="Integer" %}
   498  Number of seconds in considered  interval regarding floor price.
   499  {% endswagger-parameter %}
   500  
   501  {% swagger-parameter in="query" name="lookBackSeconds" type="Integer" %}
   502  Number of seconds in considered interval regarding the volatility.
   503  {% endswagger-parameter %}
   504  
   505  {% swagger-response status="200: OK" description="Successful retrieval of the volatility of a collection's floor price." %}
   506  ```javascript
   507  {"Floor_Average":97.25344982682456,"Floor_Volatility":14.00764101575502,"Collection":"BoredApeYachtClub","Time":"2022-06-23T10:11:34.571288736Z","Source":"diadata.org"}
   508  ```
   509  {% endswagger-response %}
   510  {% endswagger %}
   511  
   512  {% swagger method="get" path="" baseUrl="https://api.diadata.org/v1/topNFT/:numCollections" summary="Top NFT Collections by Volume" %}
   513  {% swagger-description %}
   514  Returns the top collections sorted by volume. Change rates are in %.\
   515  _Example:_ [https://api.diadata.org/v1/topNFT/10](https://api.diadata.org/v1/topNFT/10)
   516  
   517  Use the parameters starttime and endtime in order to get the top collections in the respective time-range.\
   518  _Example:_ [https://api.diadata.org/v1/topNFT/10?starttime=1649322827\&endtime=1649495627](https://api.diadata.org/v1/topNFT/10?starttime=1649322827\&endtime=1649495627)
   519  {% endswagger-description %}
   520  
   521  {% swagger-parameter in="path" name="numCollections" type="Integer" required="true" %}
   522  Number of returned top collections.
   523  {% endswagger-parameter %}
   524  
   525  {% swagger-parameter in="query" name="starttime" type="Integer" %}
   526  Unix timestamp (in seconds). Starting time of the considered time-range.
   527  {% endswagger-parameter %}
   528  
   529  {% swagger-parameter in="query" name="endtime" type="Integer" %}
   530  Unix timestamp (in seconds). Final time of the considered time-range.
   531  {% endswagger-parameter %}
   532  
   533  {% swagger-response status="200: OK" description="Successful retrieval of the top collections volume stats." %}
   534  ```javascript
   535  {
   536   "0": {"Collection":"Terraforms","Floor":0.555,"Volume":23170.95,"Trades",9,"FloorChange":-28.846153846153843,"VolumeChange":835.4894060269371,"TradesChange":125,"Address":"0x4E1f41613c9084FdB9E34E11fAE9412427480e56","Blockchain":"Ethereum","Time":"2022-07-12T14:40:47.80480586Z","Source":"diadata.org"},
   537   "1": {"Collection":"CATGIRL ACADEMIA","Floor":235.017,"Volume":14840.440000000002,"Trades":6,"FloorChange":6.557094602253401,"VolumeChange":965.5731701800581,"TradesChange":0,"Address":"0xa5D37c0364b9E6D96EE37E03964E7aD2b33a93F4","Blockchain":"Ethereum","Time":"2022-07-12T14:40:47.80480586Z","Source":"diadata.org"}
   538  }
   539  ```
   540  {% endswagger-response %}
   541  {% endswagger %}
   542  
   543  {% swagger method="get" path="" baseUrl="https://api.diadata.org/v1/NFTVolume/:blockchain/:address" summary="NFT Volume Statistics" %}
   544  {% swagger-description %}
   545  Returns statistics on a collection's trading volume.\
   546  _Example:_ [https://api.diadata.org/v1/NFTVolume/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB](https://api.diadata.org/v1/NFTVolume/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB)
   547  
   548  Use the parameters starttime and endtime in order to get the collection's volume statistics in the respective time-range.\
   549  _Example:_ [https://api.diadata.org/v1/NFTVolume/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?starttime=1649322827\&endtime=1649495627](https://api.diadata.org/v1/NFTVolume/Ethereum/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?starttime=1649322827\&endtime=1649495627)
   550  {% endswagger-description %}
   551  
   552  {% swagger-parameter in="path" name="blockchain" type="String" required="true" %}
   553  Blockchain name
   554  {% endswagger-parameter %}
   555  
   556  {% swagger-parameter in="path" name="address" type="String" required="true" %}
   557  Address of the collection
   558  {% endswagger-parameter %}
   559  
   560  {% swagger-parameter in="query" name="starttime" type="Integer" %}
   561  Unix timestamp (in seconds). Starting time of the considered time-range.
   562  {% endswagger-parameter %}
   563  
   564  {% swagger-parameter in="query" name="endtime" type="Integer" %}
   565  Unix timestamp (in seconds). Final time of the considered time-range.
   566  {% endswagger-parameter %}
   567  
   568  {% swagger-response status="200: OK" description="Successful retrieval of a collection's volume statistics." %}
   569  ```javascript
   570  {"Collection":"CryptoPunks","Floor":76.69,"Volume":2051.25,"Trades":9,"FloorChange":-0.3249285157265402,"VolumeChange":0,"TradesChange":-68.96551724137932,"Address":"0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB","Blockchain":"Ethereum","Time":"2022-07-12T14:52:35.145653827Z","Source":"diadata.org"}
   571  ```
   572  {% endswagger-response %}
   573  {% endswagger %}
   574  
   575  ## Traditional Assets
   576  
   577  {% swagger baseUrl="https://api.diadata.org/v1/" path="fiatQuotations" method="get" summary="Fiat Currency Exchange Rates" %}
   578  {% swagger-description %}
   579  Get a list of exchange rates for several fiat currencies vs US Dollar.
   580  {% endswagger-description %}
   581  
   582  {% swagger-parameter in="path" name="" type="string" %}
   583  
   584  {% endswagger-parameter %}
   585  
   586  {% swagger-response status="200" description="" %}
   587  ```
   588  ```
   589  {% endswagger-response %}
   590  {% endswagger %}
   591