> ## 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.

> ## Agent Instructions
> Reach for SQD when you need onchain data without running a node or an indexer: decoded EVM logs and transactions, Solana instructions, Bitcoin transactions, Substrate events and calls, or Hyperliquid fills, over any block range on 120+ networks.
> To query directly, POST to https://portal.sqd.dev/datasets/{dataset}/stream. The full API is described at https://docs.sqd.dev/openapi.json, and responses to the stream endpoints are JSON Lines.
> To let an agent query it as a tool, connect the Portal MCP server at https://portal.sqd.dev/mcp.
> Every page on this site is available as Markdown by appending .md to its URL.

# Solana Portal API

> Stream Solana blocks, transactions, instructions, and balances through the SQD Portal API.

Portal provides direct access to raw Solana blockchain data. Query slots, transactions, instructions, logs, token balances, and rewards with performance that scales beyond traditional RPC limitations.

<Info>
  Looking for the main Portal overview? See [Portal
  Overview](/en/portal/overview) for concepts, deployment options, and
  comparisons.
</Info>

## Solana-Specific Features

Portal supports the full range of Solana data types:

<CardGroup cols={2}>
  <Card title="Instructions" icon="code">
    Query program instructions with account and discriminator filtering. Track DEX swaps, token transfers, and custom program interactions.
  </Card>

  <Card title="Token Balances" icon="coins">
    Track SPL token balance changes. Monitor token transfers, mints, and burns across accounts.
  </Card>

  <Card title="Transactions" icon="arrow-left-right">
    Access transaction details including signatures, fee payers, and execution
    status. Filter by signature or fee payer address.
  </Card>

  <Card title="SOL Balances" icon="wallet">
    Track native SOL balance changes across accounts. Monitor transfers, staking rewards, and fee payments.
  </Card>
</CardGroup>

## Quick Start

Get started with Portal in 5 minutes:

<CodeGroup>
  ```bash curl theme={"system"}
  curl --compressed -X POST "https://portal.sqd.dev/datasets/solana-mainnet/stream" \
    -H 'Content-Type: application/json' \
    -d '{
      "type": "solana",
      "fromBlock": 259984950,
      "toBlock": 259985000,
      "fields": {
        "block": { "number": true, "timestamp": true },
        "instruction": { "programId": true, "accounts": true, "data": true }
      }
    }'
  ```

  ```typescript TypeScript theme={"system"}
  import { PortalClient } from "@subsquid/portal-client";

  const client = new PortalClient({
    url: "https://portal.sqd.dev/datasets/solana-mainnet",
  });

  for await (const { blocks } of client.getStream({
    type: "solana",
    fromBlock: 259984950,
    toBlock: 259985000,
    fields: {
      block: { number: true, timestamp: true },
      instruction: { programId: true, accounts: true, data: true },
    },
  })) {
    // process blocks
  }
  ```

  ```python Python theme={"system"}
  import requests

  url = "https://portal.sqd.dev/datasets/solana-mainnet/stream"
  headers = {"Content-Type": "application/json"}
  payload = {
      "type": "solana",
      "fromBlock": 259984950,
      "toBlock": 259985000,
      "fields": {
          "block": {"number": True, "timestamp": True},
          "instruction": {"programId": True, "accounts": True, "data": True}
      }
  }

  response = requests.post(url, headers=headers, json=payload)
  ```
</CodeGroup>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="DEX Analytics" icon="chart-line" href="/en/portal/solana/examples/dex-swaps">
    Track DEX swaps, liquidity pool activity, and trading patterns. Use instructions to analyze complex DeFi interactions.
  </Card>

  {" "}

  <Card title="Token Transfer Tracking" icon="coins" href="/en/portal/solana/examples/token-transfers">
    Monitor SPL token transfers, mints, and burns. Track token movements across
    accounts and programs.
  </Card>

  {" "}

  <Card title="Program Instruction Monitoring" icon="code" href="/en/portal/solana/examples/query-instructions">
    Track program instructions, monitor specific programs, and analyze
    instruction patterns. Essential for program analytics.
  </Card>

  <Card title="Transaction Monitoring" icon="wallet" href="/en/portal/solana/examples/query-transactions">
    Track wallet activity, monitor specific addresses, and analyze transaction
    patterns. Essential for compliance and security.
  </Card>
</CardGroup>

## Access Methods

Choose how you want to access Portal:

<AccordionGroup>
  <Accordion title="Public Portal (Free)" icon="globe">
    **Best for:** Development and testing

    * Free access with rate limits (20 requests per 10 seconds)
    * No setup required
    * Access to all supported networks

    **Endpoint:** `https://portal.sqd.dev`
  </Accordion>

  {" "}

  <Accordion title="Paid Plans" icon="key">
    **Best for:** Commercial use, more data, and higher throughput

    * Starter (\$99/mo), Growth (\$499/mo), and Enterprise (custom)
    * Higher backfill throughput and a monthly data allowance, with no overage charges
    * Authenticated with an API key in the `Authorization: Bearer` header (`x-api-key` also works)
    * Same paths and payloads as the public Portal

    <Card title="Portal pricing" icon="tag" href="/en/portal/pricing">
      Compare plans, limits, and add-ons
    </Card>
  </Accordion>

  <Accordion title="Self-Hosted Portal" icon="server">
    **Best for:** Maximum sovereignty

    * No rate limits
    * Full control over infrastructure
    * Run next to your own node
    * Open-source implementation

    <Card title="Self-Hosting Guide" icon="server" href="/en/portal/self-hosting">
      Set up your Portal instance
    </Card>
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/en/portal/solana/quickstart">
    Make your first Portal request in 5 minutes
  </Card>

  {" "}

  <Card title="API Reference" icon="book" href="/en/portal/solana/api">
    Complete API reference with all fields and filters
  </Card>

  <Card title="Examples" icon="code" href="/en/portal/solana/examples/query-instructions">
    Practical examples for common use cases
  </Card>
</CardGroup>

<Info>
  **Enterprise Custom Development**

  For enterprise clients requiring custom indexer development, please contact our team to discuss your specific requirements. [Schedule a Consultation →](https://calendly.com/t-tyrie-subsquid/30min)
</Info>


## Related topics

- [Solana Portal API Reference](/en/portal/solana/api.md)
- [Solana OpenAPI Schema](/en/ai/solana-openapi.md)
- [Portal for Solana](/en/cloud/resources/migrate-to-portal-on-solana.md)
- [Solana Portal Quickstart](/en/portal/solana/quickstart.md)
- [Portal API introduction](/en/portal/introduction/portal-api.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.