Developer

API Reference

Programmatic access to KANN data

Access indexed blockchain data through our Ponder indexer. Query historical events, track asset lifecycles, and build integrations with real-time data from Base mainnet.

Ponder Indexer API

The KANN indexer runs on Ponder, providing a SQL-over-HTTP API for querying indexed blockchain events. All data is sourced from Base mainnet (chain ID 8453).

Endpoint: https://ponder.app.kann.tech

Use the @ponder/client library for type-safe queries from JavaScript or TypeScript applications.

Using @ponder/clienttypescript

import { createClient } from "@ponder/client";

// Initialize the client
const client = createClient("https://ponder.app.kann.tech");

// Query indexed events using SQL
const offers = await client.sql`
  SELECT *
  FROM offer_created
  WHERE chain_id = 8453
  ORDER BY block_number DESC
  LIMIT 10
`;

// Query NAV updates for a specific asset
const navHistory = await client.sql`
  SELECT block_number, timestamp, nav_value
  FROM nav_updated
  WHERE asset_address = ${assetAddress}
  ORDER BY block_number DESC
`;

GraphQL Access

A GraphQL endpoint is available for more complex queries and schema exploration. The GraphQL playground can be deployed for interactive query building.

GraphQL provides schema introspection, making it useful for discovering available fields and building complex queries with filtering and pagination.

GraphQL Queriesgraphql

# Query recent offers
query RecentOffers {
  offerCreated(first: 10, orderBy: "blockNumber", orderDirection: "desc") {
    items {
      id
      offerId
      assetAddress
      blockNumber
      timestamp
    }
  }
}

# Query swap executions
query SwapHistory($assetAddress: String!) {
  swapExecuted(where: { assetAddress: $assetAddress }) {
    items {
      id
      buyer
      seller
      amount
      price
      timestamp
    }
  }
}

Available Data

The indexer tracks all significant events from KANN smart contracts deployed on Base mainnet. This includes the complete lifecycle of tokenized assets from creation through secondary trading.

Data Schemasql

-- Indexed tables available via SQL

-- Offer lifecycle events
offer_created         -- New offers created
offer_opened          -- Offers opened for subscription
offer_finalized       -- Subscription period ended
offer_settled         -- Final settlement complete

-- Trading events
swap_executed         -- Secondary market trades

-- Oracle updates
nav_updated           -- Net Asset Value changes

-- Compliance events
eligibility_added     -- Address added to allowlist
eligibility_removed   -- Address removed from allowlist

Event Categories

Offers

Complete offer lifecycle from creation through settlement. Track subscription periods, finalization, and settlement status.

Swaps

Secondary market trade executions including buyer, seller, amounts, and prices.

NAV Updates

Net Asset Value updates from the NAV oracle. Track valuation changes over time.

Eligibility

Allowlist changes including addresses added or removed with reason codes.

Authentication

The indexed data API provides public read access. No API key is required for queries against the Ponder indexer endpoint.

All indexed blockchain data is publicly readable
No authentication headers required
CORS enabled for browser-based applications

Rate Limits

The API operates under a reasonable use policy. Standard queries are not rate limited, but excessive requests may be throttled.

No hard rate limits for typical usage patterns
Large batch queries may be throttled
Contact us for enterprise access with dedicated infrastructure

Chain Information

All indexed data originates from Base mainnet. When constructing queries, use chain ID 8453 for filtering if needed.

Network

Base Mainnet

Chain ID

8453

import { createClient } from "@ponder/client"; // Initialize the client const client = createClient("https://ponder.app.kann.tech"); // Query indexed events using SQL const offers = await client.sql` SELECT * FROM offer_created WHERE chain_id = 8453 ORDER BY block_number DESC LIMIT 10 `; // Query NAV updates for a specific asset const navHistory = await client.sql` SELECT block_number, timestamp, nav_value FROM nav_updated WHERE asset_address = ${assetAddress} ORDER BY block_number DESC `;

# Query recent offers query RecentOffers { offerCreated(first: 10, orderBy: "blockNumber", orderDirection: "desc") { items { id offerId assetAddress blockNumber timestamp } } } # Query swap executions query SwapHistory($assetAddress: String!) { swapExecuted(where: { assetAddress: $assetAddress }) { items { id buyer seller amount price timestamp } } }

-- Indexed tables available via SQL -- Offer lifecycle events offer_created -- New offers created offer_opened -- Offers opened for subscription offer_finalized -- Subscription period ended offer_settled -- Final settlement complete -- Trading events swap_executed -- Secondary market trades -- Oracle updates nav_updated -- Net Asset Value changes -- Compliance events eligibility_added -- Address added to allowlist eligibility_removed -- Address removed from allowlist