Skip to content

Asset Transactions

GET /v1/assets/:asset/transactions

Get transaction history for a specific asset (paginated).

Parameters:

ParameterTypeDescription
assetstringAsset identifier in format {policy_id}.{asset_name}

Query Parameters:

ParameterTypeDefaultDescription
limitinteger100Results per page (1-500)
offsetinteger0Number of results to skip
orderstringdescSort order: asc or desc (by slot)

Example Request:

bash
# Recent IAG transactions
curl -X GET "https://api.insight.iagon.com/v1/assets/5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114.494147/transactions?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Oldest transactions first
curl -X GET "https://api.insight.iagon.com/v1/assets/5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114.494147/transactions?order=asc&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

json
{
  "success": true,
  "data": [
    {
      "tx_hash": "abc123def456...",
      "block_hash": "def789abc012...",
      "block_no": 9876543,
      "slot_no": 123456789,
      "block_time": "2024-01-15T10:30:00Z",
      "quantity": "1000000"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "last_updated": {
    "slot_no": 123456789,
    "block_hash": "abc123...",
    "block_time": "2024-01-15T10:30:00Z"
  }
}

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

json
{
  "success": false,
  "error": "Invalid asset identifier format. Expected: {policy_id}.{asset_name} where policy_id is 56 hex characters"
}

Response Fields:

FieldTypeDescription
tx_hashstring64-character hex transaction hash
block_hashstringBlock hash containing the transaction
block_nointegerBlock number
slot_nointegerSlot number
block_timestringISO 8601 timestamp
quantitystringTotal amount of asset in this transaction's outputs