Endpoints & Authentication

GraphQL Endpoint

All GraphQL queries are sent to a single endpoint:

https://graphql.chainstream.io/graphql

Both POST and GET methods are supported.

Method	Content-Type	Use Case
`POST`	`application/json`	Recommended for all queries — supports variables and complex queries
`GET`	Query string (`?query=...`)	Simple queries, browser testing, caching-friendly

Use POST for production workloads. GET requests encode the query in the URL, which has length limits and makes complex queries unwieldy.

Authentication

Authenticate by passing your API Key in the X-API-KEY header. This is the same API Key used for the REST Data API — no separate credentials needed.

X-API-KEY: your_api_key

Get your API Key from ChainStream Dashboard → Applications → Create New App. The key starts with cs_live_....

Required Headers

Header	Value	Required
`Content-Type`	`application/json`	Yes (POST)
`X-API-KEY`	`cs_live_...`	Yes

Request Format

A GraphQL request body is a JSON object with two fields:

Field	Type	Description
`query`	`string`	The GraphQL query or mutation string
`variables`	`object`	Optional variables referenced in the query via `$variable` syntax

POST Example

cURL
cURL (query file)
JavaScript (fetch)
Python (requests)

curl -X POST "https://graphql.chainstream.io/graphql" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{
    "query": "{ Solana { DEXTrades(limit: {count: 5}, orderBy: {descending: Block_Time}) { Block { Time } Trade { Buy { Currency { MintAddress } Amount } } } } }"
  }'

For complex queries, save the query to a file and reference it:

# Save query to file
cat > query.graphql << 'EOF'
{
  Solana {
    DEXTrades(limit: {count: 5}, orderBy: {descending: Block_Time}) {
      Block { Time }
      Trade {
        Buy {
          Currency { MintAddress }
          Amount
        }
      }
    }
  }
}
EOF

# Send request
curl -X POST "https://graphql.chainstream.io/graphql" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d "{\"query\": \"$(cat query.graphql | tr '\n' ' ')\"}"

const response = await fetch("https://graphql.chainstream.io/graphql", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
  },
  body: JSON.stringify({
    query: `{
      Solana {
        DEXTrades(limit: {count: 5}, orderBy: {descending: Block_Time}) {
          Block { Time }
          Trade { Buy { Currency { MintAddress } Amount } }
        }
      }
    }`,
  }),
});

const { data, extensions } = await response.json();
console.log(data.Solana.DEXTrades);

import requests

resp = requests.post(
    "https://graphql.chainstream.io/graphql",
    headers={
        "Content-Type": "application/json",
        "X-API-KEY": "your_api_key",
    },
    json={
        "query": """{
            Solana {
                DEXTrades(limit: {count: 5}, orderBy: {descending: Block_Time}) {
                    Block { Time }
                    Trade { Buy { Currency { MintAddress } Amount } }
                }
            }
        }""",
    },
)

data = resp.json()
print(data["data"]["Solana"]["DEXTrades"])

GET Example

curl -G "https://graphql.chainstream.io/graphql" \
  -H "X-API-KEY: your_api_key" \
  --data-urlencode 'query={ Solana { DEXTrades(limit: {count: 5}, orderBy: {descending: Block_Time}) { Block { Time } } } }'

Supported Networks

Wrap Cube queries in the appropriate Chain Group to select the network:

Chain Group	Blockchain	Chain ID
`Solana`	Solana	—
`EVM(network: eth)`	Ethereum	1
`EVM(network: bsc)`	BNB Chain (BSC)	56

# Solana
{ Solana { DEXTrades(limit: {count: 5}) { ... } } }

# Ethereum
{ EVM(network: eth) { DEXTrades(limit: {count: 5}) { ... } } }

# BSC
{ EVM(network: bsc) { DEXTrades(limit: {count: 5}) { ... } } }

Response Format

All responses are JSON with the following structure:

{
  "data": {
    "Solana": {
      "DEXTrades": [
        { "Block": { "Time": "2025-03-27T10:15:30Z" }, "..." : "..." }
      ]
    }
  },
  "extensions": {
    "credits": {
      "total": 50,
      "cubes": [
        { "cube": "DEXTrades", "credits": 50, "row_count": 5 }
      ]
    }
  }
}

Field	Description
`data`	The query result — matches the shape of your query
`errors`	Present only when there are validation or execution errors
`extensions.credits.total`	Total credit units consumed by this query
`extensions.credits.cubes`	Per-Cube breakdown: Cube name, credits charged, and rows returned

The extensions.credits field is included when credits are consumed. See Billing & Credits for details on how credits are calculated.

Error Response

When a query is malformed or fails, the response includes an errors array:

{
  "data": null,
  "errors": [
    {
      "message": "Unknown field 'InvalidField' on type 'DEXTrades'",
      "locations": [{ "line": 3, "column": 5 }]
    }
  ]
}

Use the GraphQL IDE to validate queries interactively before integrating them into your application. The IDE provides auto-complete and inline error highlighting.

Next Steps

Run Your First Query

Follow the step-by-step tutorial to run a real query from the IDE or cURL.

Explore the Schema

Dive into the 25 Cubes, field types, filtering operators, and aggregation functions.

Getting Started

GraphQL IDE

Schema & Data Model

Query Examples

Billing & Credits

Endpoints & Authentication

GraphQL Endpoint

Authentication

Required Headers

Request Format

POST Example

GET Example

Supported Networks

Response Format

Error Response

Next Steps

Run Your First Query

Explore the Schema

​GraphQL Endpoint

​Authentication

​Required Headers

​Request Format

​POST Example

​GET Example

​Supported Networks

​Response Format

​Error Response

​Next Steps

Run Your First Query

Explore the Schema

GraphQL Endpoint

Authentication

Required Headers

Request Format

POST Example

GET Example

Supported Networks

Response Format

Error Response

Next Steps