Skip to content
gridicon
The Grid - Public Docs
  • Pages
    • gridicon
      The Grid Developer Docs
      • icon picker
        Using the API
        • Example GraphQL queries
      • gridicon
        TGS - Data model
        • TGS Change Log
        • Lenses at The Grid
        • Full lenses
        • DB Visualisation
      • Definitions
      • Our data collection
      • Getting an API key
      • Claiming your profile
        • Ecosystem Coverage Policy
      • Reporting a data issue
    • Join The Grid
gridicon
The Grid - Public Docs
/
/
Using the API
Share
Explore
A GraphQL API for exploring blockchain data. Get started in minutes with our beta endpoint and developer tools.
To play around with the data, you can use our reference implementation
⁠
explorer.thegrid.id
⁠
or use our main discovery experince, that is based on the explorer at
thegrid.id
⁠
⁠
This can also generate queries, however be aware that the queries that are generated do use variables.
Check our Github for repos that contain the explorer and other scripts:
⁠
https://github.com/orgs/The-Grid-Data/repositories
⁠

Quickstart


Beta endpoint (TGS7 and Beyond):
ok
The Beta endpoint is at:
beta.node.thegrid.id/graphql
⁠
⁠
To start playing with it quickly:
ok
⁠
cloud.hasura.io/public/graphiql?endpoint=https://beta.node.thegrid.id/graphql
⁠

🔗 Try it now
Sample Query (cURL)
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"query": "query MyQuery { profileInfos(limit: 10) { name descriptionShort icon logo } }"
}' \
https://beta.node.thegrid.id/graphql
Python
import requests
import json

# API endpoint
API_URL = "https://beta.node.thegrid.id/graphql"

# GraphQL query
query = """
query MyQuery {
profileInfos(limit: 10) {
name
descriptionShort
icon
logo
}
}
"""

payload = {"query": query}
headers = {'Content-Type': 'application/json'}

try:
response = requests.post(API_URL, json=payload, headers=headers)
response.raise_for_status()
result = response.json()
print("Success!")
print(json.dumps(result, indent=2))
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
except json.JSONDecodeError:
print(f"Invalid JSON response: {response.text}")

✅ Response format
{
"data": {
"profileInfos": [
{
"name": "Example Profile",
"descriptionShort": "A profile description example",
"icon": "https://img.thegrid.id/harvest/icon.svg",
"logo": "https://img.thegrid.id/harvest/logo.svg"
}
]
}
}

⚠️ Error Handling
{
"data": {
"roots": null
},
"errors": [
{
"message": "internal error",
"path": [
"roots"
]
}
]
}
Common Error Scenarios
Field doesn't exist: Check schema documentation
Invalid syntax: Validate query structure
Query limit exceeded: Implement pagination or limits

Want to print your doc?
This is not the way.
Try clicking the ··· in the right corner or using a keyboard shortcut (
CtrlP
) instead.