Transaction History

GET /v1/tx/history/:address

Retrieve transaction history for a given address. Returns transaction hashes and block metadata without full input/output details. Ideal for building transaction lists with higher limits.

Parameters:

Parameter	Type	Description
`address`	string	The wallet address to query (bech32 format)

Query Parameters:

Parameter	Type	Default	Description
`limit`	number	100	Number of transactions to return (1-500)
`offset`	number	0	Number of transactions to skip
`fromSlot`	number	-	Only return transactions at or before/after this slot (depending on order)
`order`	string	desc	Sort order: `asc` (oldest first) or `desc` (newest first)

Example Request:

bash

# Basic request (newest 100 transactions)
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/tx/history/addr1qy2..." \
  -H "Authorization: Bearer YOUR_API_KEY"

# With pagination (get 500 at a time)
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/tx/history/addr1qy2...?limit=500&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Using slot-based cursor for consistent pagination
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/tx/history/addr1qy2...?fromSlot=95524660&limit=200" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

Content-Type: application/json;charset=utf-8

json

{
  "success": true,
  "data": [
    {
      "tx_hash": "402df03a9444a21e1be12550f381b9b99cb17705e697bb1b7c00859beb8bb4ae",
      "block_hash": "49394349d0dbd16276eee0654902fb0eda97fcf6286542feb66b676e39f2e59f",
      "slot_no": 95524660,
      "block_no": 4521234,
      "block_time": "2025-01-15T10:30:00.000Z"
    },
    {
      "tx_hash": "def789abc012...",
      "block_hash": "12345678abcd...",
      "slot_no": 95520000,
      "block_no": 4521100,
      "block_time": "2025-01-15T09:15:00.000Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 1500,
    "hasMore": true,
    "next_cursor": 95520000
  },
  "last_updated": {
    "slot_no": 95530000,
    "block_hash": "abc123def456...",
    "block_time": "2025-01-15T11:00:00.000Z"
  }
}

Response Fields:

Field	Type	Description
`tx_hash`	string	Transaction hash (64 hex characters)
`block_hash`	string	Block hash (64 hex characters)
`slot_no`	number	Slot number when transaction was included
`block_no`	number	Block number
`block_time`	string	ISO 8601 timestamp of block
`pagination.limit`	number	Number of results requested
`pagination.offset`	number	Number of results skipped
`pagination.total`	number	Total matching transactions
`pagination.hasMore`	boolean	Whether more results exist
`pagination.next_cursor`	number \| undefined	Slot number to use as `fromSlot` for next page
`last_updated.slot_no`	number	Latest synced slot number
`last_updated.block_hash`	string	Latest synced block hash
`last_updated.block_time`	string	Latest synced block timestamp

Use Cases:

Building transaction lists: Fetch hashes quickly, then load full details on-demand via /v1/tx/hash/:hash
Transaction counting: Use total from pagination to get address activity count
Efficient syncing: Higher limits (up to 500) allow faster initial syncs

Errors:

Status Code	Description
400	Invalid address format or query parameters
500	Internal server error

Transaction History ​

GET /v1/tx/history/:address ​

Transaction History

GET /v1/tx/history/:address