Docs
⌘ K

4 minutes

The Graph Market

The Graph Market⁠ is a data services marketplace where you can provision an API key and stream on-chain data through Substreams and Firehose, along with the Token API, Hosted Sinks, and other services.

Overview

The Graph Market lets you find a provider for the network you’re building on, create an API key, and start consuming data — without providing personal information. From a single dashboard you can manage keys, monitor usage, and deploy Hosted Sinks.

The platform serves several data services:

  • Substreams & Firehose: High-throughput, parallelized streaming of blockchain data.
  • Token API: Live and historical token data (balances, transfers, holders, and DEX swaps) across multiple chains.
  • Hosted Sinks: Managed sink deployments that write Substreams output to a destination for you.
  • Subgraphs, JSON-RPC, and Webhooks: Additional data services available across supported networks.

Get Started

Create an Account

Go to thegraph.market⁠ and sign in. Once you’re in, you’ll land on the Dashboard, which summarizes your usage for Substreams & Firehose and the Token API, your Hosted Sinks, and your API keys.

Create an API Key

From the Dashboard or the API keys page, select Create new key and give it a name (for example, my-substreams-key). Each key exposes two credentials:

  • API Key: An identifier (for example, server_1...) used for services that authenticate with a key.
  • API Token (JWT): A JSON Web Token used to authenticate Substreams and Firehose requests.

For security, the API token is hidden by default. Use the reveal (eye) icon to display it, then copy and store it securely. You can rotate or delete a key at any time from the API keys page.

Note: Treat your API token like a password. Don’t commit it to source control or expose it in client-side code.

Use Your Key with Substreams

Authenticate the CLI

Substreams authenticates with the JWT token from your API key. Export it as an environment variable so the CLI can pick it up automatically:

export SUBSTREAMS_API_TOKEN="<YOUR-JWT-TOKEN>"

Replace <YOUR-JWT-TOKEN> with the API token you copied from The Graph Market.

Choose an Endpoint

Substreams runs against a provider endpoint for your target network, passed to the CLI with the -e flag. Endpoints follow the pattern {network}.{provider}.io:443. A few examples:

NetworkEndpoint
Ethereum Mainnetmainnet.eth.streamingfast.io:443
Solana Mainnetmainnet.sol.streamingfast.io:443
Base Mainnetbase-mainnet.streamingfast.io:443
Arbitrum Onearb-one.streamingfast.io:443
Polygon Mainnetpolygon.streamingfast.io:443

Note: Select your network on The Graph Market to see the providers and endpoints available for it. For the full, up-to-date list, see Chains & Endpoints⁠ on the Substreams docs.

Run a Substreams

With your token exported, run a package against the endpoint for your network:

substreams gui \  -e mainnet.eth.streamingfast.io:443 \  [email protected] \  all_events \  --start-block=15000000

A successful run confirms your key is authenticated. To find ready-to-use packages, browse the Substreams Registry⁠.

Deploy a Hosted Sink

If you’d rather have your data written to a destination automatically, use Hosted Sinks. From the Sinks page, select New Sink, then point it at a Substreams package and configure the destination. The Dashboard tracks each deployment’s status (deployed, syncing, error, or stopped). To learn more about sink types, see Sink your Substreams.

Use the Token API

The Token API uses the same API token for authentication. Send it as a bearer token against the Token API base URL:

curl --request GET \  --url "https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208" \  --header 'Accept: application/json' \  --header 'Authorization: Bearer <YOUR-JWT-TOKEN>'

See the Token API Quick Start for the full list of endpoints.

Plans and Usage

The Graph Market offers a Free plan for both Substreams & Firehose and the Token API, with monthly included usage (for example, egress bytes and processed blocks for Substreams & Firehose, and request counts for the Token API). The Dashboard shows your consumption against these limits. Review the Pricing⁠ page for current plan tiers and included quotas.

Additional Resources