Docs
Supported ChainsAsset HubSubstrate APIChain Methods

chain_getFinalizedHead - Asset Hub RPC Method

Get the finalized block hash on Asset Hub. Essential for confirmed state queries on Polkadot's system parachain managing $4.5B+ in DOT tokens, native USDC/USDT, and NFTs.

Returns the hash of the last finalized block on Asset Hub.

Use Cases

  • Confirmed state - Query state that cannot be reverted
  • Transaction confirmation - Verify transaction finality for native stablecoin transfers (USDC, USDT), DOT staking and governance, and cross-chain asset management via XCM
  • Safe checkpoints - Use finalized blocks for critical operations

Request Parameters

Request

This method accepts no parameters.

Response Body

Response

Code Examples

Bash
curl https://api-asset-hub-polkadot.n.dwellir.com/<YOUR_API_KEY>/YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getFinalizedHead",
    "params": [],
    "id": 1
  }'
JavaScript
import { ApiPromise, WsProvider } from '@polkadot/api';

const provider = new WsProvider('wss://api-asset-hub-polkadot.n.dwellir.com/YOUR_API_KEY');
const api = await ApiPromise.create({ provider });

const finalizedHash = await api.rpc.chain.getFinalizedHead();
console.log('Finalized block hash:', finalizedHash.toHex());

// Get finalized block details
const block = await api.rpc.chain.getBlock(finalizedHash);
console.log('Finalized block number:', block.block.header.number.toNumber());

await api.disconnect();
Python
import requests

def get_finalized_head():
    url = 'https://api-asset-hub-polkadot.n.dwellir.com/<YOUR_API_KEY>/YOUR_API_KEY'

    payload = {
        'jsonrpc': '2.0',
        'method': 'chain_getFinalizedHead',
        'params': [],
        'id': 1
    }

    response = requests.post(url, json=payload)
    return response.json()['result']

finalized_hash = get_finalized_head()
print(f'Finalized block hash: {finalized_hash}')

On this page