GET
/
liquidity
/
providers
/
{providerAddress}
/
events
Provider Events
curl --request GET \
  --url https://api.amberdata.com/market/defi/liquidity/providers/{providerAddress}/events \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": [
    {
      "timestamp": 1656641568000,
      "blockNumber": 15053840,
      "transactionHash": "0xb0dc68d8290f91a27de7f1fc0cc29c431025226476396b29e2ed191f3c235d21",
      "liquidityProviderAddress": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
      "event": "swap",
      "poolAddress": "0x4cedf45d496e5bc36beda9197b0edc4957d98080",
      "poolName": "G.O.A.T_WETH",
      "poolTokenBalance": "6020.735948569006",
      "poolTokenDelta": "0",
      "token0Address": "0x74edaf28fc4b9e6a1618d613839daaf6a9d075db",
      "token0Name": "G.O.A.T Token",
      "token0Balance": 8698977467676578,
      "token0Delta": "8698602655296.459780311",
      "token1Address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1Name": "Wrapped Ether",
      "token1Balance": 118.09829266374604,
      "token1Delta": "-0.119461675221254892",
      "priceNative": "0.00000000000001357611203185345018673724327905466"
    }
  ]
}

Authorizations

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

Path Parameters

​
providerAddress
string
default:0x18f3e0c9f3bdd2e79e3eeeb1bcd8e6bb9702095f
required

The EOA address of the liquidity provider for which to retrieve events.

Query Parameters

​
exchange
string
​
size
string

[Optional] Maximum number of positions to return.<BR/>[Defaults] All (if not specified)

​
pair
string

[Optional] The liquidity pool (for example DAI/WETH) for which to filter liquidity position events. By default, events are not filtered by pool/pair.

​
timeFormat
string

[Optional] Time format of the timestamps in the return payload.<BR/>[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

​
startDate
string<date-time>
default:2022-07-01T01:00:00

[Optional] Payload only includes data after this date (inclusive). By default, startDate is 24 hours from now.<BR>[Formats] seconds | milliseconds | iso8601<BR>[Examples] 1578531600 | 1578531600000 | 2022-09-01T01:00:00

​
endDate
string<date-time>
default:2022-07-15T01:00:00

[Optional] Payload only includes data before this date (exclusive). By default, endDate is now.<BR>[Formats] seconds | milliseconds | iso8601<BR>[Examples] 1578531600 | 1578531600000 | 2022-09-15T01:00:00

​
includeMetadata
boolean
default:true

[Optional] Include data for pool information.

​
includeAllTransactionEvents
boolean
default:true

[Optional] Include all events in transactions containing events tied to the provider address.

​
page
integer

The page number to return.

Response

200 - application/json

200

​
status
integer
Example:

200

​
title
string
Example:

"OK"

​
description
string
Example:

"Successful request"

​
payload
object[]