Subsquid Network

Note
Subsquid Network has been rebranded to SQD Network. The subsquid datasource kinds (e.g. evm.subsquid) keep the original name for backward compatibility.
Warning
The v2.archive.subsquid.io gateways are legacy and scheduled for sunset in 2026.

DipDup uses Subsquid Network as a source of historical data for Substrate blockchains.

Configure the datasource in your project config:

dipdup.yaml

datasources:
  subsquid:
    kind: substrate.subsquid
    url: https://v2.archive.subsquid.io/network/asset-hub-polkadot
    api_key: ${SUBSQUID_API_KEY:-}

v2.archive.subsquid.io gateways require an API key since 2026-05-19. Provide it via the api_key field; SQD Cloud users are unaffected.

Then, add it to Substrate index definitions:

dipdup.yaml
indexes:
  assethub_transfers:
    kind: substrate.events
    runtime: assethub
    datasources:
    - subsquid
    - subscan
    - node
    handlers:
    - callback: on_transfer
      name: Assets.Transferred

DipDup will use Subsquid Network when possible and fallback to EVM nodes for the latest data and realtime updates.

Help and tips -> Join our Discord
Ideas or suggestions -> Issue Tracker
GraphQL IDE -> Open Playground