Transaction Data

Transaction history and transfer analysis

Transaction History

get

Get paginated transaction history with detailed transaction data

Authorizations

ApiKeyAuth

AuthorizationstringOptional

API key authentication for higher rate limits. To use this authentication:

1. Generate an API key at https://kairolabs.io/settings
2. Include the API key in the Authorization header as a Bearer token
3. Format: Authorization: Bearer wi_your_api_key_here

API keys provide increased rate limits compared to unauthenticated requests.

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

Example: 0x742d35cc6634C0532925a3b8D7aa5ac000000000Pattern: ^0x[a-fA-F0-9]{40}$

chainstring · enumOptional

Blockchain network identifier

Default: ethPossible values:

limitinteger · min: 1 · max: 100Optional

Maximum number of items to return

Default: 50

include_internal_transactionsbooleanOptional

Include internal transactions in results

Default: false

cursorstringOptional

Pagination cursor for next page

Responses

200

Transaction history

application/json

400

Bad request - missing or invalid parameters

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/api/wallet/history

HTTPcURLJavaScriptPython

GET /api/wallet/history?address=0x742d35cc6634C0532925a3b8D7aa5ac000000000 HTTP/1.1
Host: kairolabs.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "result": [
    {
      "hash": "text",
      "nonce": "text",
      "transaction_index": "text",
      "from_address_entity": "text",
      "from_address_entity_logo": "text",
      "from_address": "text",
      "from_address_label": "text",
      "to_address_entity": "text",
      "to_address_entity_logo": "text",
      "to_address": "text",
      "to_address_label": "text",
      "value": "text",
      "gas": "text",
      "gas_price": "text",
      "receipt_cumulative_gas_used": "text",
      "receipt_gas_used": "text",
      "receipt_contract_address": "text",
      "receipt_root": "text",
      "receipt_status": "text",
      "block_timestamp": "2025-12-16T20:49:41.981Z",
      "block_number": "text",
      "block_hash": "text",
      "internal_transactions": [
        {
          "transaction_hash": "text",
          "block_number": "text",
          "block_hash": "text",
          "type": "text",
          "from": "text",
          "to": "text",
          "value": "text",
          "gas": "text",
          "gas_used": "text",
          "input": "text",
          "output": "text"
        }
      ],
      "nft_transfers": [
        {
          "token_address": "text",
          "token_id": "text",
          "from_address_entity": "text",
          "from_address_entity_logo": "text",
          "from_address": "text",
          "from_address_label": "text",
          "to_address_entity": "text",
          "to_address_entity_logo": "text",
          "to_address": "text",
          "to_address_label": "text",
          "value": "text",
          "amount": "text",
          "contract_type": "text",
          "block_number": "text",
          "block_timestamp": "text",
          "block_hash": "text",
          "transaction_hash": "text",
          "transaction_type": "text",
          "transaction_index": 1,
          "log_index": 1,
          "operator": "text",
          "possible_spam": "text",
          "verified_collection": "text"
        }
      ],
      "erc20_transfer": [
        {
          "token_name": "text",
          "token_symbol": "text",
          "token_logo": "text",
          "token_decimals": "text",
          "transaction_hash": "text",
          "address": "text",
          "block_timestamp": "text",
          "block_number": "text",
          "block_hash": "text",
          "to_address_entity": "text",
          "to_address_entity_logo": "text",
          "to_address": "text",
          "to_address_label": "text",
          "from_address_entity": "text",
          "from_address_entity_logo": "text",
          "from_address": "text",
          "from_address_label": "text",
          "value": "text",
          "transaction_index": 1,
          "log_index": 1,
          "possible_spam": "text",
          "verified_contract": "text"
        }
      ],
      "native_transfers": [
        {
          "from_address_entity": "text",
          "from_address_entity_logo": "text",
          "from_address": "text",
          "from_address_label": "text",
          "to_address_entity": "text",
          "to_address_entity_logo": "text",
          "to_address": "text",
          "to_address_label": "text",
          "value": "text",
          "value_formatted": "text",
          "direction": "text",
          "internal_transaction": "text",
          "token_symbol": "text",
          "token_logo": "text"
        }
      ]
    }
  ],
  "cursor": "text",
  "page": 1,
  "page_size": 1
}

ERC20 Token Transfers

get

Get detailed ERC20 token transfer history

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

Example: 0x742d35cc6634C0532925a3b8D7aa5ac000000000Pattern: ^0x[a-fA-F0-9]{40}$

chainstring · enumOptional

Blockchain network identifier

Default: ethPossible values:

limitinteger · min: 1 · max: 100Optional

Maximum number of items to return

Default: 50

orderstring · enumOptional

Sort order for transfers

Default: DESCPossible values:

from_blockintegerOptional

Start block number

to_blockintegerOptional

End block number

from_datestring · date-timeOptional

Start date (ISO 8601)

to_datestring · date-timeOptional

End date (ISO 8601)

contract_addressesstring[]Optional

Filter by specific token contract addresses

cursorstringOptional

Pagination cursor for next page

Responses

200

ERC20 transfer history

application/json

400

Bad request - missing or invalid parameters

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/api/wallet/erc20-transfers

HTTPcURLJavaScriptPython

GET /api/wallet/erc20-transfers?address=0x742d35cc6634C0532925a3b8D7aa5ac000000000 HTTP/1.1
Host: kairolabs.io
Accept: */*

{
  "result": [
    {
      "token_name": "text",
      "token_symbol": "text",
      "token_logo": "text",
      "token_decimals": "text",
      "transaction_hash": "text",
      "address": "text",
      "block_timestamp": "text",
      "block_number": "text",
      "block_hash": "text",
      "to_address_entity": "text",
      "to_address_entity_logo": "text",
      "to_address": "text",
      "to_address_label": "text",
      "from_address_entity": "text",
      "from_address_entity_logo": "text",
      "from_address": "text",
      "from_address_label": "text",
      "value": "text",
      "transaction_index": 1,
      "log_index": 1,
      "possible_spam": "text",
      "verified_contract": "text"
    }
  ],
  "cursor": "text",
  "page": 1,
  "page_size": 1
}