Pool Info

GET /v1/pools/:poolId

Get comprehensive information about a stake pool including pledge, margin, stake, saturation, block production, and status.

Parameters:

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

Example Request:

# Using bech32 pool ID
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/pools/pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Using hex pool ID
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/pools/000000f66e28b0f18aef20555f4c4954234e3270dfbbdcc13f54e799" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

{
  "success": true,
  "data": {
    "pool_id": "pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc",
    "pool_id_hex": "000000f66e28b0f18aef20555f4c4954234e3270dfbbdcc13f54e799",
    "vrf_key_hash": "a1b2c3d4e5f6...",
    "pledge": "500000000000",
    "margin": 0.01,
    "fixed_cost": "340000000",
    "reward_account": "stake1uyql45vs4hrjuzyy4kmh4fewl8v46wkmwhmc9wkk8df6tdcv7pe2r",
    "owners": [
      "stake1uyql45vs4hrjuzyy4kmh4fewl8v46wkmwhmc9wkk8df6tdcv7pe2r"
    ],
    "relays": [
      {
        "ipv4": "192.168.1.1",
        "port": 3001
      },
      {
        "dns": "relay.titanstaking.io",
        "port": 3001
      }
    ],
    "metadata_url": "https://titanstaking.io/poolMetadata.json",
    "metadata_hash": "a1b2c3d4e5f6...",
    "active_stake": "64000000000000",
    "live_stake": "64500000000000",
    "delegator_count": 1250,
    "blocks_minted": 8547,
    "blocks_epoch": 42,
    "saturation": 0.8765,
    "status": "active",
    "retiring_epoch": null
  }
}

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

{
  "success": false,
  "error": "Pool 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
pool_id_hex	string	The pool ID in hex format
vrf_key_hash	string	VRF verification key hash
pledge	string	Pool pledge amount (lovelace)
margin	number	Pool margin (0-1, e.g., 0.01 = 1%)
fixed_cost	string	Fixed cost per epoch (lovelace)
reward_account	string | null	Pool reward account (stake address)
owners	string[]	Array of pool owner stake addresses
relays	object[]	Array of relay configurations
metadata_url	string | null	URL to pool metadata JSON
metadata_hash	string | null	Hash of pool metadata
active_stake	string	Active stake from epoch snapshot (lovelace)
live_stake	string	Approximate live stake (lovelace)
delegator_count	integer	Number of delegators
blocks_minted	integer	Total blocks minted by pool
blocks_epoch	integer	Blocks minted in current epoch
saturation	number	Pool saturation (0-1+, >1 means oversaturated)
status	string	Pool status: active, retiring, or retired
retiring_epoch	integer | null	Epoch when pool will retire (if retiring)