跳转到内容
Sai
本页面的翻译由 LLM 生成。如果你发现翻译有误,请在 GitHub 上提交 issue 告诉我们。

Sai Keeper 简介

Sai Keeper 简介

Sai Keeper 是提供 Nibiru 上 Sai 实时及历史数据的 GraphQL API，可查询永续合约交易、流动性池、预言机价格和费用分析。

什么是 Sai Keeper？

Section titled “什么是 Sai Keeper？”

Sai Keeper 是 Sai 的数据索引和查询层，处理链上事件，并通过快速、灵活的 GraphQL API 提供数据。

主要能力：

  • 查询仓位和历史。
  • 查看流动性池及 APY。
  • 获取预言机价格。
  • 分析费用和协议收入。
  • 通过 WebSocket 订阅实时更新。

环境

Section titled “环境”

测试网

Section titled “测试网”
  • GraphQL： https://sai-keeper.testnet-2.nibiru.fi/graphql。
  • Playground： https://sai-keeper.testnet-2.nibiru.fi/。
  • 使用测试数据，适用于开发和测试。

主网

Section titled “主网”
  • GraphQL： https://sai-keeper.nibiru.fi/graphql。
  • Playground： https://sai-keeper.nibiru.fi/。
  • 使用真实数据，适用于生产应用。

交互界面

Section titled “交互界面”

两种环境均提供交互式 GraphQL Playground：

  • 使用实时数据测试查询。
  • 测试实时订阅。
  • 通过内置文档查看模式。
  • 查看历史并保存查询。
  • 用格式化 JSON 调试响应。

在浏览器打开上述地址即可。

快速开始

Section titled “快速开始”

1. 探索 API

Section titled “1. 探索 API”

在 Playground 交互式探索模式。

2. 第一个查询

Section titled “2. 第一个查询”

尝试以下简单查询。

query GetTokenPrices {
  oracle {
    tokenPricesUsd(limit: 5) {
      token {
        symbol
        name
      }
      priceUsd
      lastUpdatedBlock {
        block
        block_ts
      }
    }
  }
}

3. 设置客户端

Section titled “3. 设置客户端”

安装 GraphQL 客户端库。

JavaScript/TypeScript：

Terminal window
npm install @apollo/client graphql
# or
npm install urql graphql

Python：

Terminal window
pip install gql[all]

Rust：

[dependencies]
graphql_client = "0.13"

核心数据领域

Section titled “核心数据领域”

Keeper 将数据分为四个主要领域。

1. Perp，永续合约

Section titled “1. Perp，永续合约”

查询和订阅合约交易数据。

  • 未平仓和已平仓仓位。
  • 交易历史及事件。
  • 市场借贷费率。

2. LP，流动性池

Section titled “2. LP，流动性池”

获取流动性提供者信息。

  • TVL、APY、份额价格。
  • 用户存款和份额。
  • 提现申请。
  • 收益追踪。

3. 预言机

Section titled “3. 预言机”

获取代币价格数据。

  • 实时 USD 价格。
  • 代币元数据。
  • 价格更新时间。

4. 费用

Section titled “4. 费用”

分析费用数据。

  • 单笔交易费用。
  • 每日统计。
  • 协议和交易者汇总。
  • 开平仓等费用明细。

GraphQL 基础

Section titled “GraphQL 基础”

以下是 GraphQL 的基本操作。

查询

Section titled “查询”

请求指定数据。

query {
  perp {
    trades(where: { trader: "nibi1abc..." }, limit: 10) {
      id
      isOpen
      leverage
    }
  }
}

订阅

Section titled “订阅”

获取实时更新。

subscription {
  perpTrades(where: { trader: "nibi1abc..." }) {
    id
    isOpen
    leverage
  }
}

变量

Section titled “变量”

为查询设置参数。

query GetTrades($trader: String!, $limit: Int) {
  perp {
    trades(where: { trader: $trader }, limit: $limit) {
      id
    }
  }
}

变量：

{
  "trader": "nibi1abc...",
  "limit": 10
}

架构概览

Section titled “架构概览”
┌─────────────────┐
│   Your App      │
│  (Frontend/     │
│   Backend)      │
└────────┬────────┘
         │
         │ GraphQL
         │ Query/Subscribe
         │
┌────────▼────────┐
│  Sai Keeper     │
│  GraphQL API    │
└────────┬────────┘
         │
         │ Indexes
         │
┌────────▼────────┐
│  Nibiru Chain   │
│  (Blockchain)   │
└─────────────────┘

Keeper 索引链数据并通过 GraphQL 提供，无需直接查询链或维护自己的索引器。

可以构建什么

Section titled “可以构建什么”
  • 交易平台： 完整永续合约界面。
  • 投资组合： 监控仓位、盈亏和表现。
  • 分析面板： 展示协议指标和用户活动。
  • 自动机器人： 用实时数据构建交易算法。
  • LP 管理： 优化头寸策略。

下一步

Section titled “下一步”