Pool Metadata

GET /v1/pools/:poolId/metadata

Get off-chain metadata for a stake pool including name, ticker, description, and homepage.

Parameters:

Parameter	Type	Description
poolId	string	The pool ID (bech32 pool1... or 56 hex characters)

Example Request:

curl -X GET "https://api.fireblocks.partners.iagon.com/v1/pools/pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc/metadata" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

{
  "success": true,
  "data": {
    "pool_id": "pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc",
    "name": "TITANstaking",
    "ticker": "TITAN",
    "description": "Professional stake pool operated by TITAN Staking",
    "homepage": "https://titanstaking.io",
    "extended": null
  }
}

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

{
  "success": false,
  "error": "Pool metadata not found"
}

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

{
  "success": false,
  "error": "Invalid pool ID format (expected pool1... or 56 hex chars)"
}

Response Fields:

Field	Type	Description
pool_id	string	The bech32 pool ID
name	string | null	Pool name
ticker	string | null	Pool ticker (1-5 characters)
description	string | null	Pool description
homepage	string | null	Pool website URL
extended	string | null	Extended metadata URL (if any)

Note

Metadata is fetched from the pool's registered metadata URL and cached by the node. If a pool has not registered metadata or the metadata URL is unavailable, this endpoint returns 404.