Returns history events for address

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

Parameters

address
* string path
Account address
limit
number query
Amount of events to return, default is 100, max is 2048
tokenAddress
string query
Token address used at event
chainId
number query
chainId
toTimestampMs
string query
To time at milliseconds
fromTimestampMs
string query
From time at milliseconds

Request Body

This request doesn’t have any request body.

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
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: {
      limit: 100,
      chainId: 1,
      toTimestampMs: 1695283931212,
      fromTimestampMs: 1694754179096,
    },
    paramsSerializer: {
      indexes: null,
    },
  };

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

Returns

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
4663
143
25
999
5042
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
AquaOrderCreate
AquaOrderClose
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
maker
string
app
string
strategyHash
string
delegateeAddress
string
orderHash
string
originType
string
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
50
51
52
53
54
55
[
  {
    "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",
            "maker": "0xd3cda913deb6f0967967d3d2f0a7ea1f5e16b122",
            "app": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
            "strategyHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
            "delegateeAddress": "0x34391448368ae60aa7dc12dc309c4ef674a06d7f",
            "orderHash": "0xdd87fbd093714d493ba53c000e4222b500e622500eeceaae9d4c4c5111ffbbfc",
            "originType": "limit-order"
          }
        }
      }
    ],
    "cache_counter": 0
  }
]

Did you find what you need?