💰Pricing with Subgraph

For current prices, subgraph pricing is deprecated. Please use api pricing

As of May 2026, Kodiak provides a single combined subgraph endpoint for both V2, V3, and Kodiak Islands. The V2 endpoint follows similar pattern to Uniswap V2 subgraph, and V3 endpoint follows similar pattern to Uniswap V3 subgraph.

Endpoint:

https://api.subgraph.ormilabs.com/api/public/d7eed6cc-ad4a-4862-8017-89893c4095d3/subgraphs/kodiak-v3/latest/gn

1. Understand the Basics of Subgraphs:

   • Subgraphs index blockchain data and expose it through GraphQL endpoints.

   • Each subgraph has entities (e.g., token, pool, transaction) that define the structure of the data you can query.

2. Read the Subgraph Documentation: Learn how subgraph works The Graph Doucmentation

3. Set Up a GraphQL Client:

   • Use tools like Postman, Insomnia, or GraphQL playgrounds to send queries.

   • In your application, you can use libraries like graphql-request or Apollo Client.

4. Know the Key Entities:

   • token: Represents individual tokens, their metadata, and derived pricing.

   • bundle: Contains aggregate data like the current price of ETH in USD.

Query examples

1. Fetching a Specific Token’s Price in ETH and USD

   {
     token(id: "TOKEN_ADDRESS") {
       id
       symbol
       name
       derivedETH
     }
     bundle(id: "1") {
       ethPriceUSD
     }
   }

   • Replace TOKEN_ADDRESS with the contract address of the token you’re querying.

   • Use thie formula to calculate USD price:

     • Token Price (USD) = derivedETH * ethPrice

2. Listing All Tokens with Derived Prices

   {
     tokens(first: 10) {
       id
       symbol
       name
       derivedETH
     }
     bundle(id: "1") {
       ethPrice
     }
   }

   Example response:

   {
     "data": {
       "tokens": [
         { "id": "0x...123", "symbol": "USDT", "name": "Tether", "derivedETH": "0.0005" },
         { "id": "0x...456", "symbol": "USDC", "name": "USD Coin", "derivedETH": "0.0005" }
       ],
       "bundle": {
         "ethPrice": "2000"
       }
     }
   }