Aptos APIs

使用这些 API 读取链上状态、提交交易、索引历史数据，以及为测试账户充值。大多数应用代码应通过官方 SDK 调用；下面的 HTTP、GraphQL 和 gRPC 端点是这些 SDK 所使用的底层服务。

选择 API

需求	使用
最新链上状态、提交交易或模拟交易	全节点 REST API
NFT、对象、历史活动或聚合表	Indexer GraphQL API
用于自定义索引器的实时或历史交易流	Transaction Stream（gRPC）
在 Devnet 或 Testnet 上获取测试 APT	水龙头 API
SQL、仪表板或第三方 RPC	数据提供商

Aptos Labs 官方端点

Aptos Labs 代表 Aptos Foundation 为每个 Aptos 网络运营这些部署。fullnode.{network}.aptoslabs.com 是 api.{network}.aptoslabs.com 的别名；请优先使用 api. 主机名。

网络	REST API（`/v1`）	Indexer GraphQL	Transaction Stream gRPC	水龙头
主网	`https://api.mainnet.aptoslabs.com/v1`	`https://api.mainnet.aptoslabs.com/v1/graphql`	`grpc.mainnet.aptoslabs.com:443`	—
测试网	`https://api.testnet.aptoslabs.com/v1`	`https://api.testnet.aptoslabs.com/v1/graphql`	`grpc.testnet.aptoslabs.com:443`	铸币页面和 `https://faucet.testnet.aptoslabs.com`（Google 登录）
开发网	`https://api.devnet.aptoslabs.com/v1`	`https://api.devnet.aptoslabs.com/v1/graphql`	`grpc.devnet.aptoslabs.com:443`	`https://faucet.devnet.aptoslabs.com`（可编程）

本站发布节点 API 规范：OpenAPI JSON 和可浏览的 REST API 参考。每个全节点还在 /v1/spec 提供实时 Swagger UI。

全节点 REST API

该 API 随每个全节点一起提供，是读取状态、提交交易和模拟交易的低延迟路径。

REST API 参考由 Aptos 节点 API OpenAPI 规范生成的可浏览文档

REST API 指南速率限制、数据裁剪、View 函数以及如何查询状态

主网浏览器针对 api.mainnet.aptoslabs.com 的实时 Swagger UI

测试网浏览器针对 api.testnet.aptoslabs.com 的实时 Swagger UI

开发网浏览器针对 api.devnet.aptoslabs.com 的实时 Swagger UI

Indexer

Indexer GraphQL API 用于 NFT、Aptos Objects、同质化资产和自定义合约数据的高级 GraphQL 接口

Transaction Stream API 面向 Aptos Core Indexing 和自定义处理器的历史与实时交易 gRPC 流

水龙头（Devnet 和 Testnet）

水龙头 API 在 Devnet 上以编程方式铸造测试 APT，或在 Testnet 上通过 Google 登录 / 铸币页面铸造

Geomi 与数据提供商

Geomi 为 Aptos Labs 托管 API 提供 API 密钥、更高速率限制、gas 代付和无代码索引

数据提供商 SQL 数据集、分析仪表板和第三方 RPC 端点

节点 API、Indexer、Transaction Stream 和水龙头的实现均在 aptos-core 开源。任何人都可以运行它们；全球有许多独立运营商和开发者选择这样做。更多 RPC 供应商见 Aptos 生态目录。

身份验证与速率限制

Labs 托管的节点、Indexer 和 Transaction Stream API 允许匿名访问，并按 IP 设置较低的速率限制。要获得更高限额和使用指标，请创建 Geomi API 密钥，并以 bearer token 发送。

curl "https://api.mainnet.aptoslabs.com/v1" \
  -H "Authorization: Bearer YOUR_API_KEY"

import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";

const aptos = new Aptos(
  new AptosConfig({
    network: Network.MAINNET,
    clientConfig: { API_KEY: process.env.APTOS_API_KEY },
  }),
);