Docs
Supported ChainsAcalaSubstrate APIChain Methods

chain_getFinalizedHead - Acala RPC Method

Get the finalized block hash on Acala. Essential for confirmed state queries on Polkadot's DeFi and liquidity hub with aUSD stablecoin and liquid staking (LDOT).

Returns the hash of the last finalized block on Acala.

Use Cases

  • Confirmed state - Query state that cannot be reverted
  • Transaction confirmation - Verify transaction finality for decentralized stablecoin (aUSD), liquid DOT staking (LDOT), and cross-chain AMM DEX
  • 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-acala.n.dwellir.com/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-acala.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-acala.n.dwellir.com/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