Transactions
The Transactions endpoint allows you to easily retrieve the transactions of any addresses
Base url
https://api.octav.fi
Method
GET
PATH
/v1/transactions
ACCESS
Restricted with an key, see API Access
Note: We do not index transactions that have more than 100,000 transactions. Please contact us if you need assistance with indexing these large datasets.
Cost per call
1 credit
Query params
Param
Description
Type
addresses *
A comma-separated list of user addresses.
string
limit *
The number of transactions to retrieve per page (min 1, max 1000)
integer
offset *
The offset for pagination.
integer
initialSearchText
Initial search text to filter transactions. Full text search in assets of the transactions (ex : 'USDC')
string
interactingAddresses
A comma-separated list of interacting addresses.
string
protocols
A comma-separated list of protocols keys to filter by.
string
hideSpam
Filter out spam transactions if specified.
string
sort
Sort order for the transactions. (DESC, ASC)
string
tokenId
Id of a token to filter on (for NFT)
string
startDate
Filter transactions starting from this date (ISO 8601 format).
string
endDate
Filter transactions ending at this date (ISO 8601 format).
string
Response Type
Response Example
{
"transactions": [
{
"assetsIn": [],
"assetsOut": [],
"chain": {
"key": "base",
"name": "Base"
},
"closedPnl": "N/A",
"fees": "0.00003625140909483",
"feesFiat": "0.1151188871792693031",
"from": "0xef7f2e81ea14538858d962df34eb1bfda83da395",
"functionName": "Exectransaction",
"hash": "0x09f048393e895fefa3252a7d61eba6d232661a4bc2b1c9c2e9730e5afc23a96d",
"timestamp": "1737335109",
"to": "0xc50cd1da00786df0a1a16b1e7886be4d0112569b",
"type": "INTERACTION",
"value": "0",
"valueFiat": "0",
"protocol": {
"name": "Unknown",
"key": "unknown"
},
"subProtocol": {
"key": "",
"name": ""
},
"nativeAssetFees": {
"balance": "0.00003625140909483",
"chainKey": "base",
"chainContract": "base:0x0000000000000000000000000000000000000000",
"contract": "0x0000000000000000000000000000000000000000",
"name": "ethereum"
}
},
{
"assetsIn": [],
"assetsOut": [],
"chain": {
"key": "base",
"name": "Base"
},
"closedPnl": "N/A",
"fees": "0.000034558500285288",
"feesFiat": "0.10966137869027873448",
"from": "0xef7f2e81ea14538858d962df34eb1bfda83da395",
"functionName": "Exectransaction",
"hash": "0xc512b7d546923d3b3be0aad230f7a0b7c01a0e85007541018ce6b98e805ad44d",
"timestamp": "1737335047",
"to": "0xc50cd1da00786df0a1a16b1e7886be4d0112569b",
"type": "FAILED",
"value": "0",
"valueFiat": "0",
"protocol": {
"name": "Wallet",
"key": "wallet"
},
"subProtocol": {
"key": "",
"name": ""
},
"nativeAssetFees": {
"balance": "0.000034558500285288",
"chainKey": "base",
"chainContract": "base:0x0000000000000000000000000000000000000000",
"contract": "0x0000000000000000000000000000000000000000",
"name": "ethereum"
}
},
{
"assetsIn": [],
"assetsOut": [],
"chain": {
"key": "base",
"name": "Base"
},
"closedPnl": "N/A",
"fees": "0.000035038798559232",
"feesFiat": "0.1110274409946384384",
"from": "0xef7f2e81ea14538858d962df34eb1bfda83da395",
"functionName": "Exectransaction",
"hash": "0x675b3afe9077245925349787d4644e0bc66a3c179968196e9c9cceee2044a99d",
"timestamp": "1737334995",
"to": "0xc50cd1da00786df0a1a16b1e7886be4d0112569b",
"type": "FAILED",
"value": "0",
"valueFiat": "0",
"protocol": {
"name": "Wallet",
"key": "wallet"
},
"subProtocol": {
"key": "",
"name": ""
},
"nativeAssetFees": {
"balance": "0.000035038798559232",
"chainKey": "base",
"chainContract": "base:0x0000000000000000000000000000000000000000",
"contract": "0x0000000000000000000000000000000000000000",
"name": "ethereum"
}
},
{
"assetsIn": [],
"assetsOut": [],
"chain": {
"key": "base",
"name": "Base"
},
"closedPnl": "N/A",
"fees": "0.000002940710829997",
"feesFiat": "0.00930902598211360329",
"from": "0xef7f2e81ea14538858d962df34eb1bfda83da395",
"functionName": "Exectransaction",
"hash": "0x8832b19ef688358878c212bc6feb9779d997f1d38c0a5c161ccdfe94382eb777",
"timestamp": "1737334865",
"to": "0xc50cd1da00786df0a1a16b1e7886be4d0112569b",
"type": "INTERACTION",
"value": "0",
"valueFiat": "0",
"protocol": {
"name": "Unknown",
"key": "unknown"
},
"subProtocol": {
"key": "",
"name": ""
},
"nativeAssetFees": {
"balance": "0.000002940710829997",
"chainKey": "base",
"chainContract": "base:0x0000000000000000000000000000000000000000",
"contract": "0x0000000000000000000000000000000000000000",
"name": "ethereum"
}
},
{
"assetsIn": [
{
"balance": "1.2909e-14",
"chainContract": "base:0x4200000000000000000000000000000000000006",
"chainKey": "base",
"contract": "0x4200000000000000000000000000000000000006",
"decimal": "18",
"name": "weth",
"price": "3160.1389171586366",
"symbol": "weth",
"value": "4.07942332816008398694e-11",
"nft": {
"tokenId": ""
},
"to": "0xef7f2e81ea14538858d962df34eb1bfda83da395",
"totalCostBasis": "N/A",
"isNativeAssetFees": false,
"from": "0x9562cbd309c466cff835126f246be479308df72b",
"costBasis": "N/A",
"closedPnl": "N/A"
}
],
"assetsOut": [],
"chain": {
"key": "base",
"name": "Base"
},
"closedPnl": "N/A",
"fees": "0.000239156291282052",
"feesFiat": "0.75842917185403304604",
"from": "0xef7f2e81ea14538858d962df34eb1bfda83da395",
"functionName": "Exectransaction",
"hash": "0xace449050f93c11696bb78016f3df78b21bf071f758b8fa5f44f9a363ff2aa15",
"timestamp": "1737334583",
"to": "0xc50cd1da00786df0a1a16b1e7886be4d0112569b",
"type": "DEPOSIT",
"value": "0",
"valueFiat": "0",
"protocol": {
"name": "Wallet",
"key": "wallet"
},
"subProtocol": {
"key": "",
"name": ""
},
"nativeAssetFees": {
"balance": "0.000239156291282052",
"chainKey": "base",
"chainContract": "base:0x0000000000000000000000000000000000000000",
"contract": "0x0000000000000000000000000000000000000000",
"name": "ethereum"
}
}
]
}Last updated