> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sqd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.sqd.dev/feedback

```json
{
  "path": "/en/api/substrate/finalized-head",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Finalized Dataset Head

> Returns the highest available finalized block number and hash.

<Warning>**Real-time streaming is not supported for Substrate chains.** Only finalized historical data is available. If you need real-time Substrate data, [schedule a call with our team](https://calendly.com/t-tyrie-subsquid/30min).</Warning>


## OpenAPI

````yaml en/api/catalog/substrate/openapi.yaml GET /finalized-head
openapi: 3.1.0
info:
  title: SQD Portal API - Substrate Dataset Endpoints
  description: >-
    API endpoints for interacting with Substrate datasets under the SQD Portal,
    specifically for the Polkadot dataset.
  version: 1.0.0
servers:
  - url: https://portal.sqd.dev/datasets/polkadot
    description: SQD Portal's endpoint for Polkadot
security: []
paths:
  /finalized-head:
    get:
      summary: Finalized Dataset Head
      description: Returns the highest available finalized block number and hash.
      responses:
        '200':
          description: Finalized block head info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockHead'
      x-codeSamples:
        - lang: shell
          source: >
            curl --compressed
            'https://portal.sqd.dev/datasets/polkadot/finalized-head'
        - lang: python
          label: Finalized Dataset Head
          source: |
            import requests

            response = requests.get(
                "https://portal.sqd.dev/datasets/polkadot/finalized-head"
            )
            data = response.json()
        - lang: javascript
          label: Finalized Dataset Head
          source: >
            const response = await
            fetch("https://portal.sqd.dev/datasets/polkadot/finalized-head");

            const data = await response.json();
components:
  schemas:
    BlockHead:
      type: object
      properties:
        number:
          type: integer
          format: int64
          description: Block number of the highest available block
        hash:
          type: string
      nullable: true

````