API

The DIA base url is https://api.diadata.org. All API paths are sub-paths of this base URL.

get
Chart Points

https://api.diadata.org/v1/chartPoints/:filter/:exchange/:symbol
Get chart points for an exchange. https://api.diadata.org/v1/chartPoints/MEDIR120/Binance/BTC For a list of available exchanges see: https://docs.diadata.org/documentation/api-1#api-access or: https://docs.diadata.org/documentation/api-1/api-endpoints#exchanges Remark: Successful responses can be rather large.
Request
Response
Request
Path Parameters
filter
required
string
Which filter should be applied (Available options: MEDIR120 and MAIR120).
exchange
required
string
Which exchange to use.
symbol
required
string
A valid symbol from GET /v1/coins, e.g., BTC.
Query Parameters
scale
optional
string
Which scale the graph points distance should have. Available options: 5m 30m 1h 4h 1d 1w.
Response
200: OK
Successful retrieval of a chart point.
{"DataPoints":[{"Series":[{"name":"filters","columns":["time","exchange","filter","symbol","value"],"values":[["2020-05-19T08:02:09Z","GateIO","MEDIR120","EOS",2.6218717017500084]]}],"Messages":null}]}

get
Chart Points for all Exchanges

https://api.diadata.org/v1/chartPointsAllExchanges/:filter/:symbol
Get symbol details for all exchanges. Example: https://api.diadata.org/v1/chartPointsAllExchanges/MEDIR120/EOS Remark: Careful! Successful responses can be rather large.
Request
Response
Request
Path Parameters
filter
required
string
Which filter should be applied (Available options: MEDIR120 and MAIR120).
symbol
required
string
A valid symbol from GET /v1/coins, e.g., BTC.
Query Parameters
scale
optional
string
Which scale the graph points distance should have. Available options: 5m 30m 1h 4h 1d 1w
Response
200: OK
Successful retrieval of a chart point for all exchanges.
{"DataPoints":[{"Series":[{"name":"filters","columns":["time","exchange","filter","symbol","value"],"values":[["2020-05-19T08:17:59Z",null,"MEDIR120","EOS",2.6236194301032314]]}],"Messages":null}]}

get
Interest Rate

https://api.diadata.org/v1/interestrate/:rateType
Get value for a certain rate type. Example: https://api.diadata.org/v1/interestrate/ESTER/2020-04-20​ Get rate values for a range of timestamps using optional query parameters. Example: https://api.diadata.org/v1/interestrate/ESTER?dateInit=2020-02-20&dateFinal=2020-04-16
Request
Response
Request
Path Parameters
rateType
required
string
Symbol name for a rate.
date
optional
string
Return the rate for the specified date. Default date is the latest available date. Format: yyyy-mm-dd
Query Parameters
dateInit
optional
string
Initial date for range queries. Format yyyy-mm-dd
dateFinal
optional
string
Final date for range queries. Format: yyyy-mm-dd
Response
200: OK
Successful retrieval of an interest rate.
{"Symbol":"ESTER","Value":-0.542,"PublicationTime":"2020-05-19T07:15:07Z","EffectiveDate":"2020-05-18T00:00:00Z","Source":"ECB"}

get
Quotation

https://api.diadata.org/v1/quotation/:symbol
Get most recent information on the currency corresponding to symbol. Example: https://api.diadata.org/v1/quotation/BTC
Request
Response
Request
Path Parameters
symbol
required
string
Which symbol to get a quotation for, e.g., BTC.
Response
200: OK
Successful retrieval of the BTC symbol.
{"Symbol":"BTC","Name":"Bitcoin","Price":9777.19339776667,"PriceYesterday":9574.416265039981,"VolumeYesterdayUSD":298134760.8811487,"Source":"diadata.org","Time":"2020-05-19T08:41:12.499645584Z"}

get
Supply

https://api.diadata.org/v1/supply/:symbol
Get the circulating supply for the currency corresponding to symbol. Example: https://api.diadata.org/v1/supply/BTC
Request
Response
Request
Path Parameters
symbol
required
string
Which symbol to get the supply for, e.g., BTC
Response
200: OK
Successful retrieval of BTC supply.
{"Symbol":"BTC","Name":"Bitcoin","CirculatingSupply":17655550,"Source":"diadata.org","Time":"2019-04-20T08:44:25.748170404Z","Block":0}

get
Symbol

https://api.diadata.org/v1/symbol/:symbol
Get extensive information on the cryptocurrency corresponding to symbol on various exchanges.
Request
Response
Request
Path Parameters
symbol
required
string
Which symbol to get the details on, e.g., BTC
Response
200: OK
Information on the cryptocurrency organized by "Change", "Coin", "Rank", "Exchanges" and "Gfx1" (filtered data). Shown below is an exerpt of a succesful response of symbol = BTC.
"Change":{"USD":[{"Symbol":"EUR","Rate":0.8995232526760818,"RateYesterday":0.8995232526760818},...
"Coin":{"Symbol":"BTC","Name":"Bitcoin","Price":9780.807149999986,"PriceYesterday":9574.416265039981,"VolumeYesterdayUSD":354341949.0902907,"Time":"2020-05-19T10:13:22.895692183Z","CirculatingSupply":17655550},...
"Rank":1
"Exchanges":[{"Name":"Huobi","Price":9776.344026379707,"PriceYesterday":9566.082031390646,"VolumeYesterdayUSD":182131794.24870485,"Time":"2020-05-19T10:07:59Z","LastTrades":...
"Gfx1":{"DataPoints":[{"Series":[{"name":"filters","columns":["time","exchange","filter","symbol","value"],"values":[["2020-05-19T10:08:00Z",null,"MA120","BTC",9780.807149999986],...

get
CVI Index

https://api.diadata.org/v1/cviIndex
Get all values of the Crypto Volatility Index. Example: https://api.diadata.org/v1/cviIndex Example with query parameters: https://api.diadata.org/v1/cviIndex?starttime=1589829000&endtime=1589830000
Request
Response
Request
Query Parameters
starttime
optional
integer
Unix timestamp setting the start of the return array
endtime
optional
integer
Unix timestamp setting the end of the return array
Response
200: OK
Succesful retrieval of CVI Index value for starttime=1589829000 and endtime=1589830000
[{"Timestamp":"2020-05-18T19:12:43Z","Value":142.28101897342574},{"Timestamp":"2020-05-18T19:17:48Z","Value":142.29282246717017},{"Timestamp":"2020-05-18T19:22:51Z","Value":142.3025697159107}]

get
Coins

https://api.diadata.org/v1/coins
Get a list of all available coins. https://api.diadata.org/v1/coins
Request
Response
Request
Response
200: OK
Successful retrieval of available coins along with actual information on prices. Shown below is an exerpt of the full response.
"CompleteCoinList":[{"Symbol":"BTC","Name":"Bitcoin"},{"Symbol":"ETH","Name":"Ethereum"},...
"Change":{"USD":[{"Symbol":"EUR","Rate":0.8995232526760818,"RateYesterday":0.8995232526760818},...
"Coins":[{"Symbol":"BTC","Name":"Bitcoin","Price":9773.78345474998,"PriceYesterday":9574.416265039981,"VolumeYesterdayUSD":352085287.0431704,"Time":"2020-05-19T10:05:53.191886175Z","CirculatingSupply":17655550},...

get
Exchanges

https://api.diadata.org/v1/exchanges
Get a list of all available trading places. https://api.diadata.org/v1/exchanges
Request
Response
Request
Response
200: OK
Successful retrieval of available exchanges.
["Binance","Bitfinex","Bittrex","CoinBase","GateIO","HitBTC","Huobi","Kraken","LBank","OKEx","Quoine","Simex","ZB"]

get
Interest Rates

https://api.diadata.org/v1/interestrates
Get a list of all available interest rates along with metadata on the rates such as first publication date and issuing entity. https://api.diadata.org/v1/interestrates
Request
Response
Request
Response
200: OK
Successful retrieval of meta information on available interest rates.
[{"Symbol":"ESTER","FirstDate":"2019-10-01T00:00:00Z","Issuer":"ECB"},{"Symbol":"SOFR90","FirstDate":"2020-03-02T00:00:00Z","Issuer":"FED"},{"Symbol":"SONIA","FirstDate":"1997-01-02T00:00:00Z","Issuer":"BOE"},{"Symbol":"SAFR","FirstDate":"2020-03-02T00:00:00Z","Issuer":"FED"},{"Symbol":"SOFR","FirstDate":"2018-04-02T00:00:00Z","Issuer":"FED"},{"Symbol":"SOFR180","FirstDate":"2020-03-02T00:00:00Z","Issuer":"FED"},{"Symbol":"SOFR30","FirstDate":"2020-03-02T00:00:00Z","Issuer":"FED"}]

get
Pairs

https://api.diadata.org/v1/pairs
Get a list of all available trading pairs organized by exchanges. https://api.diadata.org/v1/pairs
Request
Response
Request
Response
200: OK
Successful retrieval of trading pairs along with the respective exchange. Shown below is an exerpt of the full response.
{"Pairs":[{"Symbol":"BTC","ForeignName":"","Exchange":"Huobi","Ignore":false},{"Symbol":"ETH","ForeignName":"","Exchange":"Binance","Ignore":false},...

get
Symbols

https://api.diadata.org/v1/symbols
Get a list of all available symbols for cryptocurrencies. https://api.diadata.org/v1/symbols
Request
Response
Request
Response
200: OK
Successful retrieval of available symbols for cryptocurrencies. Shown below is an exerpt of the full response.
{"Symbols":["EOS","QTUM","BCH","BFT","FLDC","NXS","BLOCK","GAM","GLD","LOOM",...

get
Raw crypto trades

https://api.diadata.org/kafka/tradesBlock
Get a list of all trades that comprised the last block that was used to calculate the latest information on crypto asset pricing.
Request
Response
Request
Path Parameters
offset
optional
integer
Get historical blocks (use the current offset returned in a response to calculate the offset you want to get)
Response
200: OK
A list of trades wrapped into a block with additional meta information like the time span of this specific block.
{"Result":{"offset":433850,"messages":[[{"BlockHash":"v1_4d7b1e936e7e0808d9ab17a43ec5ef8a","TradesBlockData":{"BeginTime":"2020-05-20T12:24:00Z","EndTime":"2020-05-20T12:26:00Z","TradesNumber":5674,"Trades":[{"Symbol":"EOS","Pair":"EOS_ETH","Price":0.01243882,"Volume":0.0325,"Time":"2020-05-20T12:24:00.050719107Z","ForeignTradeID":"c0d40b32","EstimatedUSDPrice":2.649370741608955,"Source":"LBank"}]}}]]}}

get
Compounded Average

https://api.diadata.org/v1/compoundedAvg/:rateType/:period/:dpy/:date
Get the average value of a given interest rate compounded over a period of time. Example: https://api.diadata.org/v1/compoundedAvg/SOFR/30/360/2020-05-14 Get compounded averages for a range of dates using the query parameters. Example: https://api.diadata.org/v1/compoundedAvg/SOFR/30/360?dateInit=2020-04-24&dateFinal=2020-05-14 For the methodology see: https://docs.diadata.org/documentation/methodology/traditional-assets/compounded-rates#standard-methodology
Request
Response
Request
Path Parameters
rateType
required
string
Symbol for a rate name
period
required
integer
Rate is compounded over period days
dpy
required
string
Business day convention for the number of days per year
date
required
string
Return the compounded rate for the date specified in the format yyyy-mm-dd
Query Parameters
dateInit
optional
string
Initial date for range queries. Format: yyyy-mm-dd
dateFinal
optional
string
Final date for range queries. Format: yyyy-mm-dd
Response
200: OK
Successful retrieval of a compounded average of the SOFR over an interest period of 30 days.
{"Symbol":"SOFR30_compounded_by_DIA","Value":0.035667157687857554,"PublicationTime":"0001-01-01T00:00:00Z","EffectiveDate":"2020-05-14T00:00:00Z","Source":"FED"}

get
Compounded Average by DIA

https://api.diadata.org/v1/compoundedAvgDIA/:rateType/:period/:dpy/:date
Coming soon!
Request
Response
Request
Path Parameters
optional
string
Response
200: OK