🟢Query Transaction Data
Get our MEV transaction data with simple steps!
This is EigenPhi Pro Plan Service
API endpoint
https://api.eigenapi.io/transactions
?chain=<chain>
&type=<type>
&start_time=<start_time>
&end_time=<end_time>
&limit=<limit>
&apikey=<apikey>Quota
10 calls per second for each API key
Request
Query Parameters
chain
required
values supported:
ethereum or bsc
apikey
required
type
Values supported:
arbitrage, sandwich, liquidation or lending
start_time
The starting timestamp, representing the Unix timestamp in seconds.
end_time
The ending timestamp, representing the Unix timestamp in seconds. default: LatestBlock
limit
The max number of response records. A range of (0, 150] is supported. default: 100
Response (Arbitrage type)
Arbitrage is a trading strategy that allows traders to generate profit from price differences across different trading platforms.With our transaction data API, you can easily investigate the arbitrage transactions that occurred on both Ethereum and Binance Smart Chain.
We provide all the arbitrage transactions that have occurred from on-chain data based on the time range you select. The data we provide enables you to analyze the profits, costs and the specific protocols or pools utilized in each arbitrage transaction..
For example, the following response signifies an arbitrage transaction occurred between the liquidity pool of Uniswap V3:WETH/GETH and Uniswap V2:WETH/GETH.
{
"data": [
{
"blockNumber": 16681373,
"blockTimestamp": 1677037151,
"chain": "ethereum",
"cost": 10.710180888,
"gasPrice": 46792911209,
"pools": [
{
"address": "0x0ce2f0a319fe761e8ca975414558c12900c717c2",
"name": "Uniswap V3:WETH/GETH",
"protocol": "Uniswap V3",
"symbol": "UNI-V3",
"tokens": [
{
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "WETH"
},
{
"address": "0xdd69db25f6d620a7bad3023c5d32761d353d3de9",
"symbol": "GETH"
}
]
},
{
"address": "0x4b1e9a9de809ce968c7dfb0e66f91bb7d794f3ed",
"name": "Uniswap V2:WETH/GETH",
"protocol": "Uniswap V2",
"symbol": "UNI-V2",
"tokens": [
{
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "WETH"
},
{
"address": "0xdd69db25f6d620a7bad3023c5d32761d353d3de9",
"symbol": "GETH"
}
]
}
],
"profit": 1.324268139,
"revenue": 12.034449027,
"tokens": [
{
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"symbol": "WETH"
},
{
"address": "0xdd69db25f6d620a7bad3023c5d32761d353d3de9",
"symbol": "GETH"
}
],
"transactionFromAddress": "0x4dd36c49b200a6d52ebb365f01bf0e4db8b9f765",
"transactionHash": "0xed700c7aca69e1057d004c47de70a6a282563bb9cf3b5bec7b413b530c26fe48",
"transactionIndex": 2,
"transactionToAddress": "0x6af1a16fde7346e7729fa921ad2ddf6a462061e2",
"type": "Arbitrage"
}
]
}
Response(Sandwich type)
A sandwich transaction group comprises of multiple transactions, with a typical group consisting of: the attacker's front-running transaction, the victim's transaction, and the attacker's back-running transaction.
In this API response, we provide a sandwichDetails field that represents the transactions that made up the sandwich transaction group.
The sandwichRole field indicates the role of each transaction. For example：FrontRun, Victim, BackRun
{
"data": [
{
.....
"sandwichDetails": [
{
"sandwichRole": "FrontRun",
"transactionFromAddress": "0x77223f67d845e3cbcd9cc19287e24e71f7228888",
"transactionHash": "0x92997a6e83584a4d7f62f2189866b68efba6790f8f3cc7c019f3e8ad5ee0c0a0",
"transactionIndex": 0,
"transactionToAddress": "0x00000000a991c429ee2ec6df19d40fe0c80088b8"
},
{
"sandwichRole": "Victim",
"transactionFromAddress": "0x088333f39cd07ae034c0476d3b0ea68b2ab4ed19",
"transactionHash": "0xacd27872b1298fd22164646b38e9c715733dea15f80ca2247f76a1e23853c1ab",
"transactionIndex": 1,
"transactionToAddress": "0x881d40237659c251811cec9c364ef91dc08d300c"
},
{
"sandwichRole": "BackRun",
"transactionFromAddress": "0x77223f67d845e3cbcd9cc19287e24e71f7228888",
"transactionHash": "0xc2bc3ede185bae82c68d1313cc2bf89c4c83fe9bca229f15c1e4069f36733fa3",
"transactionIndex": 2,
"transactionToAddress": "0x00000000a991c429ee2ec6df19d40fe0c80088b8"
}
],
......
"type": "Sandwich"
}
]
}Response(Liquidation type)
We provide liquidation data covering multiple protocols on the Ethereum chain. Currently, liquidation transactions happened in Aave V1, Aave V2, Compound, MakerDao, Liquity protocol are available in our responses. We will cover more lending platforms as necessary to provide more liquidation results.
In the response, we provide a liquidationDetails field that represents a specific liquidation data.
Please note that there may be multiple liquidations in a single transaction.
{
"data": [
{
.....
"liquidationDetails": [
{
"borrowToken": {
"address": "0xf629cbd94d3791c9250152bd8dfbdf380e2a3b9c",
"symbol": "ENJ"
},
"borrowTokenPrice": 0.5244913795694414,
"borrowTokenVolume": 1175.062098781,
"borrower": "0x6af11ed2008131c091ba3171bd0bb3b5248316bc",
"collateralToken": {
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"symbol": "USDC"
},
"collateralTokenPrice": 1.0,
"collateralTokenVolume": 1234.992377,
"liquidator": "0x4df5ac795699be45bf449f022ee9c7ddcb46f448",
"protocol": "Aave V2"
}
],
......
"type": "Liquidation"
}
]
}Response(Lending type)
We provide lending data (with lending type of: Deposit, Withdrow, Borrow, Repay) for multiple protocols on the ethernet chain。Currently supported protocols: Aave V1，Aave V2，Compound
In the response, we provide a lendingDetails field
{
"data": [
{
.....
"lendingDetails": [
{
"address": "0x3c5fe9bad06ca2f64082295958a20da9c7260ad7", //Address where the operation was initiated
"lendingType": "Withdraw", //Deposit，Withdraw，Borrow，Repay
"protocol": "Aave V2", //protocol：AAVE V2，Compound，AAVE V1
"token": {
"address": "0x514910771af9ca656af840dff83e8264ecf986ca",
"symbol": "LINK"
},
"tokenAmount": 2600.53316334657, //Number of Token
"tokenVolume": 20262.310644652 // The value of Token (usd)
}
],
........
"type": "Lending"
}
]
}Error Codes
Errors consist of two parts: an error code and a message. Codes are universal, but messages can vary.
401 UNAUTHORIZED
Please provide valid API key in the apikey query parameter.
{"errcode": 401, "err":"Please provide valid API key in the apikey query parameter."}429 Quota limit exceeded
{"errcode": 429, "err":"Quota limit exceeded"} 10000 not_support_chain
Query parameter chain only supports [ethereum,bsc]
{"errcode": 10000, "err":"not_support_chain"} 10001 not_support_type
Query parameter type only supports [sandwich,liquidation,arbitrage,lending]
{"errcode": 10001, "err":"not_support_type"} Last updated