Getting Started

Build on Sai with comprehensive technical documentation, API references, and integration guides.

Build powerful applications on top of Sai's perpetual futures protocol. Whether you're creating trading bots, analytics dashboards, or custom integrations, this documentation will guide you through the process.

Quick Start

Choose your integration path based on your development environment:

EVM Integration Guide

Start here if you're building on EVM chains. Covers environment setup, contract connections, and basic operations like opening positions and managing collateral

WASM Integration Guide

For WASM-based chains and clients. Learn integration patterns with language-specific examples and deployment guidance

---

Sai Core

Comprehensive documentation of the Sai smart contracts, modules, and architecture.

Core Modules

Perp Contract

Main perpetual futures contract handling position management, collateral, and settlement

Borrowing Module

Borrowed funds management, interest rates, and liquidation mechanics

Price Impact Module

How large trades affect pricing, slippage calculation, and execution costs

Reference Documentation

State Variables

Complete reference of all smart contract state variables and their purposes

Contract Addresses Reference

Mainnet and testnet deployment addresses for all Sai contracts

WASM & EVM Integration

Platform-specific details for direct smart contract integration

---

Sai Keeper

Query and subscribe to real-time data from the Sai protocol. Perfect for dashboards, bots, and analytics tools.

Getting Started

Core Concepts

Understand indexing, subscriptions, and how Keeper structures protocol data

Client Setup

Get your GraphQL client configured and authenticated in minutes

API Reference

Perp API

Query positions, orders, trades, and perpetual-specific data

Liquidity Provider (LP) API

Access liquidity pool data, provider positions, and performance metrics

Oracle API

Get price feeds and oracle data used throughout the protocol

Fees API

Query fee structures, accruals, and historical fee data

Examples & Advanced Usage

Examples: Queries

Copy-paste ready GraphQL queries for common use cases

Examples: Subscriptions

See how to subscribe to real-time updates and build event-driven applications

Filters & Pagination

Master filtering, sorting, and pagination for efficient large-scale data retrieval

---

Use Cases

Practical integration examples and real-world applications built on Sai.

Telegram Bot Integration

Build a Telegram trading bot with position monitoring, alerts, and order execution

---

Developer Resources

Need help or want to connect with other builders?

• 🐦 X / Twitter - @SaiDotFun

• 📢 Telegram News Channel - t.me/saidotfun

• 📸 Instagram - instagram.com/saidotfun

• 🎵 TikTok - @saidotfun

Additional Resources:

• Contract Addresses - Quick reference for all deployed contracts

• GraphQL Playground - Test queries interactively

---

Ready to build? Start with the EVM Integration Guide or WASM Integration Guide based on your development stack.