Skip to main content
GET
/
liquidity
/
providers
/
return
/
{liquidityPoolAddress}
Provider Historical Return
curl --request GET \
  --url https://api.amberdata.com/market/defi/liquidity/providers/return/{liquidityPoolAddress} \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "data": [
      {
        "protocol": "uniswapv2",
        "start": "2021-04-15T14:33:19.000Z",
        "end": "2021-04-20T23:28:11.000Z",
        "poolAddress": "0xbb2b8038a1640196fbe3e38816f3e67cba72d940",
        "holderAddress": "0x0fd0489d5ccf0acc0ccbe8a1f1e638e74cab5bd7",
        "token0Address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
        "token1Address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "token0IfHeld": "7.69629322069794075337",
        "token1IfHeld": "196.32525698445629500982",
        "token0Lp": "7.89254172795109418119",
        "token1Lp": "191.99999294918886972483",
        "change0": "-0.1848047632082587482626456123346393385466",
        "change1": "4.6036532857354736745709037354984946732638",
        "fees0Total": "0.0114437440448946795573543876653606614534",
        "fees1Total": "0.2783892504680483895809037354984946732638",
        "fees0Unclaimed": "0.0114437440448946795573543876653606614534",
        "fees1Unclaimed": "0.2783892504680483895809037354984946732638",
        "fees0Claimed": "0",
        "fees1Claimed": "0",
        "positionOpen": true,
        "fees": 1295.8211510760418,
        "feesClaimed": 0,
        "feesUnclaimed": 1295.8211510760418,
        "impermanentLoss": 275.5484361723138,
        "return": 1020.272714903728
      }
    ],
    "metadata": {
      "columns": [
        "protocol"
      ]
    }
  }
}

Authorizations

​
x-api-key
string
header
default:API_KEY
required

Path Parameters

​
liquidityPoolAddress
string
default:0xbb2b8038a1640196fbe3e38816f3e67cba72d940
required

The address of the liquidity pool.

Query Parameters

​
addresses
string
default:0x0fd0489d5ccf0acc0ccbe8a1f1e638e74cab5bd7
required

A comma separated list of liquidity provider addresses.
[Maximum] 10 addresses

​
startDate
string<date-time>
default:1618497199
required

[Optional] Payload only includes data after this date (inclusive).
[Formats] seconds | milliseconds | iso8601
[Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
endDate
string<date-time>
default:1618961291
required

[Optional] Payload only includes data before this date (exclusive).
[Formats] seconds | milliseconds | iso8601
[Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

Response

200 - application/json

200

​
status
integer
default:0
Example:

200

​
title
string
Example:

"OK"

​
description
string
Example:

"Successful request"

​
payload
object