Policy Assets

GET /v1/assets/policy/:policyId

Get all assets under a specific policy ID (paginated).

Parameters:

Parameter	Type	Description
`policyId`	string	56-character hex policy ID

Query Parameters:

Parameter	Type	Default	Description
`limit`	integer	100	Results per page (1-500)
`offset`	integer	0	Number of results to skip
`order`	string	`desc`	Sort order: `asc` or `desc` (by total supply)

Example Request:

bash

# All IAG policy assets
curl -X GET "https://api.insight.iagon.com/v1/assets/policy/5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114" \
  -H "Authorization: Bearer YOUR_API_KEY"

# First 5 assets
curl -X GET "https://api.insight.iagon.com/v1/assets/policy/5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

json

{
  "success": true,
  "data": [
    {
      "asset_name": "494147",
      "asset_name_ascii": "IAG",
      "fingerprint": "asset1nzfpk7mtqc40pnzyf5daqy3csqcff6rjzqstgj",
      "total_supply": "1000000000000000",
      "mint_count": 1,
      "burn_count": 0
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 1,
    "hasMore": false
  },
  "last_updated": {
    "slot_no": 123456789,
    "block_hash": "abc123...",
    "block_time": "2024-01-15T10:30:00Z"
  }
}

Response Fields:

Field	Type	Description
`asset_name`	string	Hex-encoded asset name
`asset_name_ascii`	string \| null	ASCII representation if valid UTF-8
`fingerprint`	string	CIP-14 fingerprint (`asset1...`)
`total_supply`	string	Current circulating supply
`mint_count`	integer	Number of mint events
`burn_count`	integer	Number of burn events

Use Cases

This endpoint is useful for:

Discovering all NFTs in a collection (same policy ID)
Finding all tokens under a project's policy
Auditing token supply across a policy

Policy Assets ​

GET /v1/assets/policy/:policyId ​

Policy Assets

GET /v1/assets/policy/:policyId