Transaction stake pool registration and update certificates

GET /txs/:hash/pool_updates

Obtain information about stake pool registration and update certificates of a specific transaction.

Request

Path Parameters

hash 64-character case-sensitive hexadecimal string required
Hash of the requested transaction
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Responses

• 200
• 400
• 403
• 404
• 418
• 429
• 500

---

Obtain information about stake pool certificates of a specific transaction

application/json

Schema

Example (from schema)

---

Schema

• Array [
cert_index integer required

Index of the certificate within the transaction

pool_id string required

Bech32 encoded pool ID

vrf_key string required

VRF key hash

pledge string required

Stake pool certificate pledge in Lovelaces

margin_cost number required

Margin tax cost of the stake pool

fixed_cost string required

Fixed tax cost of the stake pool in Lovelaces

reward_account string required

Bech32 reward account of the stake pool

owners string[] required
metadata objectnullablerequired

url string nullable required

URL to the stake pool metadata

hash string nullable required

Hash of the metadata file

ticker string nullable required

Ticker of the stake pool

name string nullable required

Name of the stake pool

description string nullable required

Description of the stake pool

homepage string nullable required

Home page of the stake pool

relays object[]required
Array [
ipv4 string nullable required
IPv4 address of the relay
ipv6 string nullable required
IPv6 address of the relay
dns string nullable required
DNS name of the relay
dns_srv string nullable required
DNS SRV entry of the relay
port integer required
Network port of the relay
]
active_epoch integer required

Epoch in which the update becomes active

• ]

[
  {
    "cert_index": 0,
    "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
    "vrf_key": "0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233",
    "pledge": "5000000000",
    "margin_cost": 0.05,
    "fixed_cost": "340000000",
    "reward_account": "stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f",
    "owners": [
      "stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"
    ],
    "metadata": {
      "url": "https://stakenuts.com/mainnet.json",
      "hash": "47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c",
      "ticker": "NUTS",
      "name": "Stake Nuts",
      "description": "The best pool ever",
      "homepage": "https://stakentus.com/"
    },
    "relays": [
      {
        "ipv4": "4.4.4.4",
        "ipv6": "https://stakenuts.com/mainnet.json",
        "dns": "relay1.stakenuts.com",
        "dns_srv": "_relays._tcp.relays.stakenuts.com",
        "port": 3001
      }
    ],
    "active_epoch": 210
  }
]

Bad request

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 400,
  "error": "Bad Request",
  "message": "Backend did not understand your request."
}

Authentication secret is missing or invalid

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 403,
  "error": "Forbidden",
  "message": "Invalid project token."
}

Component not found

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 404,
  "error": "Not Found",
  "message": "The requested component has not been found."
}

IP has been auto-banned for extensive sending of requests after usage limit has been reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 418,
  "error": "Requested Banned",
  "message": "IP has been auto-banned for flooding."
}

Usage limit reached

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 429,
  "error": "Project Over Limit",
  "message": "Usage is over limit."
}

Internal Server Error

application/json

Schema

Example (from schema)

---

Schema

status_code integer required
error string required
message string required

{
  "status_code": 500,
  "error": "Internal Server Error",
  "message": "An unexpected response was received from the backend."
}

Loading...