/paras/leases/current - Polkadot

Example code for the /paras/leases/current REST method. Complete guide on how to use /paras/leases/current REST in GetBlock Web3 documentation.

This endpoint returns the current parachain lease period and the parachains that currently hold a lease. It is a relay-chain endpoint.

Endpoint

GET /paras/leases/current

Query Parameters

Parameter	Type	Required	Description
at	string	No	Block height or hash to query at

Request

cURL

curl --location 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/paras/leases/current'

JavaScript

example.js

const response = await fetch('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/paras/leases/current');
const data = await response.json();
console.log(data);

Python

example.py

import requests

response = requests.get('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/paras/leases/current')
print(response.json())

Response

{
  "at": {
    "hash": "0x255bc00927df8d33d561792635cbc6bde480a0a505eef5ff28630ece3fc15b32",
    "height": "6754362"
  },
  "leasePeriodIndex": "42",
  "endOfLeasePeriod": "6800000",
  "currentLeaseHolders": [
    "2004",
    "2006"
  ]
}

Response Fields

Field	Type	Description
leasePeriodIndex	string	Current lease period index
endOfLeasePeriod	string	Block at which the current lease period ends
currentLeaseHolders	array	Parachain IDs currently holding a lease

Use Cases

• Slot Tracking: Track which parachains hold slots

• Lease Expiry: Read when the current lease period ends

• Ecosystem Tools: Monitor slot occupancy

• Analytics: Study parachain slot tenure