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

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
networks	A comma-separated list of networks to filter by. Chains supported by Octav	string
txTypes	A comma-separated list of transaction types keys to filter by. Transaction type	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

Transaction[]

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"
      }
    }
  ]
}