Get history events by address

POSThttps://api.1inch.com/history/v2.0/history/{address}/events
Supported on:
EthereumBaseBNB ChainZKsyncGnosisOptimismPolygonSonicUnichainArbitrumAvalanche

Parameters

address
* string path

Request Body

PostMultiFilterDto object
filter
*MultiFilterDto object
from_time_ms
object
to_time_ms
object
chain_ids
array
items
string
transaction_types
array
items
string
token_addresses
array
items
string
chain_based_token_addresses
array
items
string
limit
number
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
const axios = require('axios');

async function httpCall() {
  const url = 'https://api.1inch.com/history/v2.0/history/{address}/events';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };
  const body = {
    filter: {
      from_time_ms: null,
      to_time_ms: null,
      chain_ids: ['string'],
      transaction_types: ['string'],
      token_addresses: ['string'],
      chain_based_token_addresses: ['string'],
      limit: 0,
    },
  };

  try {
    const response = await axios.post(url, body, config);
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

Returns

201
400
401
500
array
items
HistoryResponseDto object
items
* array
items
HistoryEventDto object
id
* string
address
* string
type
* number
rating
* string (Enum)
Reliable
Scam
timeMs
* number
details
*TransactionDetailsDto object
orderInBlock
* number
txHash
* string
chainId
* number (Enum)
1
45
137
10
56
42161
43114
100
250
1313161554
8217
324
8453
59144
501
146
130
blockNumber
* number
blockTimeSec
* number
status
* string
type
* string (Enum)
Unknown
Approve
Wrap
Unwrap
Send
Receive
Transfer
Swap
LimitOrderCreate
LimitOrderFill
LimitOrderCancel
LimitOrderCancelAll
AddLiquidity
RemoveLiquidity
Borrow
Repay
Stake
Unstake
DelegateVotePower
UnDelegateVotePower
Claim
Bridge
Burn
RegisterDomain
Revoke
CreateSafe
NativeSwapEscrow
MultiSigExecution
tokenActions
* array
items
TokenActionDto object
address
* string
standard
* string
fromAddress
* string
toAddress
* string
tokenId
object
amount
object
direction
* string (Enum)
In
Out
Self
On
fromAddress
* string
toAddress
* string
nonce
* number
feeInSmallestNative
* string
meta
TransactionDetailsMetaDto object
is1inchFusionSwap
object
is1inchCrossChainSwap
object
orderFillPercentage
object
ensDomainName
object
fromChainId
object
toChainId
object
safeAddress
object
protocol
object
cache_counter
* number
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
[
  {
    "items": [
      {
        "id": 7279741913753607,
        "address": "0x266E77cE9034a023056ea2845CB6A20517F6FDB7",
        "type": 1,
        "rating": "Reliable",
        "timeMs": 1694754179096,
        "details": {
          "orderInBlock": 2,
          "txHash": "0xdd87fbd093714d493ba53c000e4222b500e622500eeceaae9d4c4c5111ffbbfc",
          "chainId": 1,
          "blockNumber": "18182982",
          "blockTimeSec": "1695283931",
          "status": "Completed",
          "type": "Transfer",
          "tokenActions": [
            {
              "address": "0xc944e90c64b2c07662a292be6244bdf05cda44a7",
              "standard": "ERC20",
              "fromAddress": "0x266e77ce9034a023056ea2845cb6a20517f6fdb7",
              "toAddress": "0x03f7724180aa6b939894b5ca4314783b0b36b329",
              "tokenId": "0x03f7724180aa6b939894b5ca4314783b0b36b329",
              "amount": "291000000000",
              "direction": "Out"
            }
          ],
          "fromAddress": "0x266e77ce9034a023056ea2845cb6a20517f6fdb7",
          "toAddress": "0xc944e90c64b2c07662a292be6244bdf05cda44a7",
          "nonce": 5,
          "feeInSmallestNative": "378906276289230",
          "meta": {
            "is1inchFusionSwap": true,
            "is1inchCrossChainSwap": true,
            "orderFillPercentage": 2,
            "ensDomainName": "usd.eth",
            "fromChainId": "56",
            "toChainId": "1",
            "safeAddress": "0x34391448368ae60aa7dc12dc309c4ef674a06d7f",
            "protocol": "Gnosis"
          }
        }
      }
    ],
    "cache_counter": 0
  }
]

Did you find what you need?