GraphQL API Overview

Loading diagram...

Intuition provides GraphQL APIs for querying its knowledge graph in a convenient and versatile way.

Available endpoints

Intuition mainnet

https://mainnet.intuition.sh/v1/graphql

Try on GraphQL Explorer

Intuition testnet

https://testnet.intuition.sh/v1/graphql

Try on GraphQL Explorer

Alternatively, you can import these URLs from the GraphQL package:

import { API_URL_PROD, API_URL_DEV } from '@0xintuition/graphql'

If this is your first time using GraphQL, you can learn more at graphql.org.

There are a few ways to get started with this GraphQL API, depending on the level of abstraction and customization you require :

SDK

Integrate with Intuition smart contracts using our TypeScript SDK.

Custom Queries

Create bespoke GraphQL queries for your specific use case.

GraphQL Package

Install it with NPM

Install and use the NPM package with ready-made React Query hooks.

Use it as a GraphQL Generator

Use the GraphQL package to generate your own queries and mutations.

See GraphQL in Action

Check out these complete tutorials using the GraphQL API:

• Finding Top Dapps - Query and rank decentralized applications by market cap
• Building Activity Feeds - Create real-time user activity streams
• Discovering Trusted Accounts - Build trust graphs and find reliable accounts
• Finding Related Claims - Traverse the knowledge graph to find connections

More tutorials →

Interactive Playground

Try the Intuition GraphQL API straight from your browser! The playground below connects to the live testnet endpoint and allows you to explore the knowledge graph in real time.

Query

query GetAtoms {
  atoms(limit: 10, order_by: { created_at: desc }) {
    term_id
    label
    emoji
    type
    image
    created_at
    block_number
    creator {
      id
      label
    }
  }
}

Variables

Click "Run Query" to execute the GraphQL query and see results