Detailed Transaction History

GET /v1/tx/address/:address

Retrieve detailed transaction history for a given address, including full inputs and outputs with asset details.

Parameters:

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

Query Parameters:

Parameter	Type	Default	Description
limit	number	20	Number of transactions to return (1-100)
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)
groupByPolicy	boolean	false	Group assets by policy ID instead of flat format

Example Request:

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

# With pagination
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/tx/address/addr1qy2...?limit=50&offset=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

Response:

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

{
  "success": true,
  "data": [
    {
      "tx_hash": "402df03a9444a21e1be12550f381b9b99cb17705e697bb1b7c00859beb8bb4ae",
      "block_hash": "49394349d0dbd16276eee0654902fb0eda97fcf6286542feb66b676e39f2e59f",
      "slot_no": 95524660,
      "block_no": 4521234,
      "block_time": "2025-01-15T10:30:00.000Z",
      "fee": 180000,
      "size": 512,
      "inputs": [
        {
          "tx_hash": "abc123def456...",
          "output_index": 0,
          "address": "addr1qy...",
          "value": {
            "lovelace": 5000000,
            "assets": {
              "87264e48adc75c4472c4e52e80acd36051ca153f42ee339fb04f5a28.token": 100
            }
          }
        }
      ],
      "outputs": [
        {
          "output_index": 0,
          "address": "addr1qx...",
          "value": {
            "lovelace": 2000000
          }
        },
        {
          "output_index": 1,
          "address": "addr1qy...",
          "value": {
            "lovelace": 2820000,
            "assets": {
              "87264e48adc75c4472c4e52e80acd36051ca153f42ee339fb04f5a28.token": 100
            }
          }
        }
      ]
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 150,
    "hasMore": true,
    "next_cursor": 95520000
  },
  "last_updated": {
    "slot_no": 95530000,
    "block_hash": "abc123def456...",
    "block_time": "2025-01-15T11:00:00.000Z"
  }
}

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

{
  "success": false,
  "error": "Invalid address format"
}

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
fee	number	Transaction fee in lovelace
size	number	Transaction size in bytes
inputs	array	Array of transaction inputs
inputs[].tx_hash	string	Source transaction hash
inputs[].output_index	number	Source output index
inputs[].address	string	Source address
inputs[].value	object	Input value (lovelace + assets)
outputs	array	Array of transaction outputs
outputs[].output_index	number	Output index
outputs[].address	string	Destination address
outputs[].value	object	Output value (lovelace + assets)
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

Errors:

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