API Endpoints

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

Digital Assets

get
Symbols

https://api.diadata.org/v1/symbols
Get a list of all available symbols for cryptocurrencies. Example: https://api.diadata.org/v1/symbols Get symbols restricted to an exchange using the query parameter. (For the moment only for centralized exchanges). Example: https://api.diadata.org/v1/symbols?exchange=Kraken
Request
Response
Request
Query Parameters
exchange
optional
string
Name of the crypto exchange.
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
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","ITIN":"DXVPYDQC3"}

get
Exchanges

https://api.diadata.org/v1/exchanges
Get a list of all available crypto exchanges. 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
Farming Pools

https://api.diadata.org/v1/FarmingPools
Get a list of all available farming pools.
Request
Response
Request
Response
200: OK
Succesful retrieval of available farming pools.
[{"ProtocolName":"YFI","InputAsset":["3crv"],"PoolID":"3crv"},{"ProtocolName":"YFI","InputAsset":["DAI"],"PoolID":"DAI"}]

get
Farming Pool Data

https://api.diadata.org/v1/FarmingPoolData/:protocol/:poolID
Get the most recent information on a specific farming pool, such as pool rate and pool balance. Available pools can be found in the FarmingPools endpoint https://docs.diadata.org/documentation/api-1/api-endpoints#farming-pools Example: https://api.diadata.org/v1/FarmingPoolData/YFI/USDT Get information for a time range using the query parameters. Example: https://api.diadata.org/v1/FarmingPoolData/YFI/USDT?dateInit=1603886821&dateFinal=1603887121
Request
Response
Request
Path Parameters
protocol
required
string
The name of the protocol in capital letters.
poolID
required
string
Unique identifier of the pool.
Query Parameters
dateInit
optional
integer
Unix timestamp. Initial date for range queries.
dateFinal
optional
integer
Unix timestamp. Final date for range queries.
Response
200: OK
[{"Rate":0.03660467237864349,"Balance":1716667.854526,"ProtocolName":"YFI","BlockNumber":11145033,"PoolID":"USDT","TimeStamp":"2020-10-28T12:11:38Z","OutputAsset":["USDT"],"InputAsset":["USDT"]},{"Rate":0.03660460740229476,"Balance":1716667.746922,"ProtocolName":"YFI","BlockNumber":11145029,"PoolID":"USDT","TimeStamp":"2020-10-28T12:10:38Z","OutputAsset":["USDT"],"InputAsset":["USDT"]},{"Rate":0.036604532499305786,"Balance":1716667.622879,"ProtocolName":"YFI","BlockNumber":11145024,"PoolID":"USDT","TimeStamp":"2020-10-28T12:09:38Z","OutputAsset":["USDT"],"InputAsset":["USDT"]}]

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
Supply

https://api.diadata.org/v1/supply/:symbol
Get the current circulating supply for the token 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
Supplies

https://api.diadata.org/v1/supplies/:symbol
Get all recorded supply values for the token corresponding to symbol. Example: https://api.diadata.org/v1/supplies/BTC Get supply values for a time range using the query parameters. Example: https://api.diadata.org/v1/supplies/BTC?starttime=1602232273&endtime=1602318673
Request
Response
Request
Path Parameters
symbol
required
string
Which symbol to get the supply fot, e.g., BTC
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
Successful retrieval of two supply values for Bitcoin (BTC) between timestamps 1591700000 and 1591883936.
[{"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}]

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 excerpt of a successful 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
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
Trade Volume

https://api.diadata.org/v1/volume/:symbol
Get the trading volume of the specified symbol in a defined time span.
Request
Response
Request
Path Parameters
symbol
required
string
Which symbol to retrieve the volume of (e.g. BTC)
Query Parameters
starttime
optional
integer
Start of the timespan (Unix time in seconds)
endtime
optional
integer
End of the timespan (Unix time in seconds)
Response
200: OK
An example response when querying a BTC volume for a typical day.
1431527525.7309263

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
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
Successful 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
Defi Interest Rate

https://api.diadata.org/v1/defiLendingRate/:protocol/:asset
Get information about a Defi protocol's lending and borrowing rates. Time parameter is optional. If omitted, the most recent rate is returned. Example: https://api.diadata.org/v1/defiLendingRate/COMPOUND/USDC Get rates for a range of timestamps using optional query parameters. https://api.diadata.org/v1/defiLendingRate/COMPOUND/USDC?dateInit=1591646100&dateFinal=1595246100
Request
Response
Request
Path Parameters
protocol
required
string
Name of the protocol, in uppercase
asset
required
string
Asset short name, e.g. ETH for Ether
time
optional
integer
Unix timestamp. Default is the latest available rate
Query Parameters
dateInit
optional
integer
Initial Unix timestamp for range queries
dateFinal
optional
integer
Final Unix timestamp for range queries
Response
200: OK
Successful retrieval of a Defi interest rate.
{"Timestamp":"2020-07-20T11:54:56Z","LendingRate":1.250020254710238,"BorrowingRate":4.856778356760549,"Asset":"USDC","Protocol":{"Name":"COMPOUND","Address":"0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b","UnderlyingBlockchain":"Ethereum","Token":""}}

get
Defi Lending Protocol

https://api.diadata.org/v1/defiLendingState/:protocol
Get meta information about a defi lending protocol such as the underlying blockchain, its name and its currently locked value in USD and ETH. An example request can look like this: https://api.diadata.org/v1/defiLendingState/COMPOUND
Request
Response
Request
Path Parameters
protocol
required
string
Name of the protocol, e.g. COMPOUND
Response
200: OK
Successful response containing locking volume, the timestamp of data recording and protocol meta information such as name and the underlying blockchain.
{"TotalUSD":13048619504.89947,"TotalETH":52570793.80784482,"Timestamp":"2020-07-22T16:27:31Z","Protocol":{"Name":"COMPOUND","Address":"0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b","UnderlyingBlockchain":"Ethereum","Token":""}}

get
Guest Symbols

https://api.diadata.org/v1/foreignSymbols/:source
Get the list of available symbols along with their ITIN for guest quotations. Example: https://api.diadata.org/v1/foreignSymbols/Coingecko
Request
Response
Request
Path Parameters
source
required
string
source of the quotation
Response
200: OK

get
Guest Quotation

https://api.diadata.org/v1/foreignQuotation/:source/:symbol
Get the latest quotation for a token from a guest source. Example: https://api.diadata.org/v1/foreignQuotation/Coingecko/BTC Use the query parameter time in order to get the latest quotation before the specified timestamp. Example: https://api.diadata.org/v1/foreignQuotation/Coingecko/BTC?time=1601351679
Request
Response
Request
Path Parameters
source
required
string
source of the quotation
symbol
required
string
Which symbol to get a quotation for, e.g. BTC
Query Parameters
time
optional
number
Unix timestamp.
Response
200: OK

Traditional Assets

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
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
Compounded Index

https://api.diadata.org/v1/compoundedRate/:rateType/:dpy/:date
Get the value of an index compounded since its first publication date. Example: https://api.diadata.org/v1/compoundedRate/SOFR/360/2020-05-14 Get the compounded index for a range of dates using the query parameters. Example: https://api.diadata.org/v1/compoundedRate/SOFR/360?dateInit=2020-04-24&dateFinal=2020-05-14 For the methodology of compounded rates 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
dpy
required
integer
Business day convention for the number of days per year
date
required
string
Return the compounded index 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 the SOFR Index.
{"Symbol":"SOFR_compounded_by_DIA","Value":1.0414032009923273,"PublicationTime":"0001-01-01T00:00:00Z","EffectiveDate":"2020-05-14T00:00:00Z","Source":"FED"}

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 the 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 Remark: This Get method requires an API key. Please contact us for more information: https://docs.google.com/forms/d/e/1FAIpQLSePxDwbEURjes4nw8GUzaT-XfYttRw_6F2xAR607FKACsn7ew/viewform
Request
Response
Request
Path Parameters
rateType
required
string
Symbol for a rate name
period
required
integer
Rate is compounded over period days
dpy
required
integer
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 calendar 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 using DIA Method

https://api.diadata.org/v1/compoundedAvgDIA/:rateType/:period/:dpy/:date
Get the average value of an interest rate compounded over a period of time. Here, we use the DIA methodology for compounding the rate, i.e. interest is compounded for non-business days as well. For details see: https://docs.diadata.org/documentation/methodology/traditional-assets/compounded-rates#dia-methodology Example: https://api.diadata.org/v1/compoundedAvgDIA/SOFR/30/360/2020-05-14 Get the compounded average for a range of dates using the query parameters. Example: https://api.diadata.org/v1/compoundedAvgDIA/SOFR/30/360?dateInit=2020-04-24&dateFinal=2020-05-14 Remark: This Get method requires an API key. Please contact us for more information: https://docs.google.com/forms/d/e/1FAIpQLSePxDwbEURjes4nw8GUzaT-XfYttRw_6F2xAR607FKACsn7ew/viewform
Request
Response
Request
Path Parameters
rateType
required
string
Symbol for a rate name
period
required
integer
Rate is compounded over period days
dpy
required
integer
Business 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 the compounded average of SOFR over an interest period of 30 calendar days.
[{"Symbol":"SOFR30_compounded_by_DIA","Value":0.035667175187725775,"PublicationTime":"0001-01-01T00:00:00Z","EffectiveDate":"2020-05-14T00:00:00Z","Source":"FED"}]

get
Fiat Currency Exchange Rates

https://api.diadata.org/v1/fiatQuotations
Get a list of exchange rates for several fiat currencies vs US Dollar.
Request
Response
Request
Path Parameters
optional
string
Response
200: OK

get
Gold price in Gram

https://api.diadata.org/v1/goldPaxgGrams
Gold price for 1g of Gold measured by the PAXG commodity token.
Request
Response
Request
Response
200: OK
{"Symbol":"PAXG-gram","Name":"PAXG-gram","Price":59.69023528449715,"PriceYesterday":57.93549261152835,"VolumeYesterdayUSD":0,"Source":"diadata.org","Time":"2020-11-25T11:22:31.146028646Z","ITIN":"undefined"}