ADA-API

Purpose:

Retrieve historical data from Cardano decentralized exchanges (DEX).

How to use:

Each request returns data related to the day span between the start_time and end_time query parameters:

    http://***/v1/[dex-id]/pools?pair=LQ/ADA&start_time=2022-05-08T10:52:57Z&end_time=2022-05-08T14:52:57Z

NOTE Start and end times are in RFC 3339 format
NOTE Start and end times must represent a time span of one month or less

dex-id: the Cardano DEX identifier for the given API (sundae, minswap, wingriders etc)
pair: the trade pair to lookup. This can be any pair, but currently we index only the top 50 traded currencies on each dex roughly every 1 minute.
start-time: the start of the window in time you wish to retrieve data for. If we have the historical data, it will be returned. Our API started ingesting data in April of 2022.
end-time: the end of the window in time you wish to retrieve data for.

Trade pairs names may be retrieved from the /names endpoint:

http://***/v1/[dex-id]/names?start_time=2022-05-08T10:52:57Z&end_time=2022-05-08T14:52:57Z

Sample response:

{
	"pools_available": [
		"AADA/ADA",
		"ADAL/ADA",
		"ADAO/ADA",
		"ADAX/ADA",
		"AGIX/ADA",
		"ASHIB/ADA",
		"BLC/ADA",
		"Banana/ADA",
		"CARDS/ADA",
		"CARGO/ADA",
		"CHARLI3/ADA",
		"CLAP/ADA",
		"CNFT/ADA",
		"Charlz Token/ADA"
	]
}

Best Practice:

Each request is cached and returned by the day, regardless of the time value. We do this to cache the requests across multiple users of the API. When you enter your start and end times, the pool values returned will always be one day’s worth of data or more. It is best to return a single day’s worth of data when possible. Each day is roughly 5MB worth of API data straight from the associated dex.

Currently, you can only perform a valid query when the start_time and end_time are one month apart or less. Perform multiple queries with one month spans to work around this limit.

Sundaeswap Sample Response:

GET 200 OK

{
	"history": {
		"poolsPopular": [
			{
				"lookup_date": "2022-04-30T13:54:50.000369Z",
				"apr": 0,
				"rewards": null,
				"assetA": {
					"assetId": "",
					"policyId": "",
					"assetName": null,
					"decimals": 6,
					"logo": null,
					"ticker": "ADA",
					"dateListed": "2022-04-23 06:27:26.643663158 +0000 UTC m=+6839.809788267"
				},
				"assetB": {
					"assetId": "da8c30857834c6ae7203935b89278c532b3995245295456f993e1d24.4c51",
					"policyId": "820182018282051a016002d88200581c3aa01dba02b37245f31d099806af04bb883214181fa899f5e8d34c37",
					"assetName": "LQ",
					"decimals": 6,
					"logo": "https://cdn.sundaeswap.finance/logos/138/13863539188509198801.png",
					"ticker": "LQ",
					"dateListed": "2022-04-23 06:24:16.814666791 +0000 UTC"
				},
				"assetLP": {
					"assetId": "0029cb7c88c7567b63d1a512c0ed626aa169688ec980730c0473b913.6c70208301",
					"policyId": "0029cb7c88c7567b63d1a512c0ed626aa169688ec980730c0473b913",
					"assetName": "6c70208301",
					"decimals": 0,
					"logo": null,
					"ticker": "6c70208301",
					"dateListed": "2022-04-21 14:18:50.551073555 +0000 UTC"
				},
				"fee": "0.05",
				"quantityA": "13512395778",
				"quantityB": "145655125",
				"quantityLP": "1402380413",
				"ident": "8301",
				"assetID": "0029cb7c88c7567b63d1a512c0ed626aa169688ec980730c0473b913.70208301",
				"tvl": "21725783795.947289",
				"name": "LQ/ADA",
				"priceUSD": "74.579538"
			}
		]
	}
}

Minswap Sample Response:

{
	"history": {
		"topPools": [
			{
				"ID": 760791455520063490,
				"CreatedAt": "2022-05-11T01:05:26.356023-04:00",
				"UpdatedAt": "2022-05-11T01:05:26.356023-04:00",
				"DeletedAt": null,
				"lookup_date": "2022-05-11T01:05:26.356023-04:00",
				"assetB": {
					"currencySymbol": "1d7f33bd23d85e1a25d87d86fac4f199c3197a2f7afeb662a0f34e1e",
					"tokenName": "776f726c646d6f62696c65746f6b656e",
					"metadata": {
						"name": "World Mobile Token",
						"ticker": "WMT",
						"url": "https://worldmobiletoken.com",
						"decimals": 6
					}
				},
				"reserveA": 4954803591370,
				"reserveB": 9902608835854,
				"lpAsset": {
					"currencySymbol": "e4214b7cce62ac6fbba385d164df48e157eae5863521b4b67ca71d86",
					"tokenName": "df88a770e300f248b776231b96da4525ce0f54bc457310efe27a03f2c14bb18f",
					"metadata": {
						"name": "",
						"ticker": "",
						"url": "",
						"decimals": 0
					}
				},
				"totalLiquidity": 6980991650659,
				"reserveADA": "9909607182740",
				"volumeADAByDay": "181324595224",
				"volumeADAByWeek": "1869699414483",
				"pendingOrders": 3,
				"tradingFeeARP": 2,
				"name": "WMT/ADA"
			},
			{
				"ID": 760791206327582722,
				"CreatedAt": "2022-05-11T01:04:10.247874-04:00",
				"UpdatedAt": "2022-05-11T01:04:10.247874-04:00",
				"DeletedAt": null,
				"lookup_date": "2022-05-11T01:04:10.247874-04:00",
				"assetB": {
					"currencySymbol": "1d7f33bd23d85e1a25d87d86fac4f199c3197a2f7afeb662a0f34e1e",
					"tokenName": "776f726c646d6f62696c65746f6b656e",
					"metadata": {
						"name": "World Mobile Token",
						"ticker": "WMT",
						"url": "https://worldmobiletoken.com",
						"decimals": 6
					}
				},
				"reserveA": 4954803591370,
				"reserveB": 9902608835854,
				"lpAsset": {
					"currencySymbol": "e4214b7cce62ac6fbba385d164df48e157eae5863521b4b67ca71d86",
					"tokenName": "df88a770e300f248b776231b96da4525ce0f54bc457310efe27a03f2c14bb18f",
					"metadata": {
						"name": "",
						"ticker": "",
						"url": "",
						"decimals": 0
					}
				},
				"totalLiquidity": 6980991650659,
				"reserveADA": "9909607182740",
				"volumeADAByDay": "181524595224",
				"volumeADAByWeek": "1869699414483",
				"pendingOrders": {
					"limit": 1,
					"market": 3,
					"overSlippage": 3,
					"total": 7
				}
				"tradingFeeARP": 2.01,
				"name": "WMT/ADA"
			}
		]
	}
}