Skip to main content
Get up and running with Portal to access raw EVM blockchain data in minutes.

​
Prerequisites

No installation required. Use curl from your terminal.

​
Installation

1

Choose your access method

Portal offers three ways to access blockchain data:
  • Public Portal: Free, rate-limited access for development
  • Cloud Portal: Managed access through SQD Cloud
  • Self-Hosted Portal: Run your own instance
For this quickstart, we’ll use the Public Portal endpoint.
2

Install dependencies (optional)

No installation needed.

​
Your First Query

Query the last 1,000 blocks from Ethereum mainnet: 
curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 18000000,
    "toBlock": 18001000,
    "fields": {
      "block": {
        "number": true,
        "timestamp": true,
        "gasUsed": true
      }
    }
  }'

​
Understanding the Response

Portal returns data in newline-delimited JSON format. Each line represents one block: 
{
  "header": {
    "number": 18000000,
    "timestamp": 1697544779,
    "gasUsed": "12534567"
  },
  "transactions": [],
  "logs": []
}
The response includes only the fields you requested. This keeps responses fast and bandwidth-efficient.

​
Query Event Logs

Track USDC Transfer events: 
curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 18000000,
    "toBlock": 18010000,
    "fields": {
      "log": {
        "address": true,
        "topics": true,
        "data": true,
        "transactionHash": true
      }
    },
    "logs": [{
      "address": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],
      "topic0": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }]
  }'
Filter at the Portal level to reduce bandwidth and improve performance. Only request the fields you need.

​
Rate Limits

The Public Portal has the following limits:
  • 20 requests per 10 seconds
  • Suitable for development and testing
For production use, consider Cloud Portal or Self-Hosted Portal.

​
Next Steps

Explore practical examples for common use cases:

Query Event Logs

Track smart contract events

Query Transactions

Monitor wallet activity

Track NFT Transfers

Index NFT collection activity

Index DEX Swaps

Build DEX analytics

View All Examples

Browse all Portal examples