# Table of Contents - [兑换 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-dex-api-web3-api-docs-okx-wallet) - [什么是 OKX OS | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-okx-os-web3-api-docs-okx-wallet) - [介绍 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [支持的网络 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-web3-api-docs-okx-wallet) - [介绍 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-defi-api-web3-api-docs-okx-wallet) - [申请 DApp 入驻 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-dapp-web3-api-docs-okx-wallet) - [接口规范 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-web3-api-docs-okx-wallet) - [接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-web3-api-docs-okx-wallet) - [更新日志 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-web3-api-docs-okx-wallet) - [OKX Web3 Build 用户协议 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#okx-web3-build-web3-api-docs-okx-wallet) - [签名 SDK | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-sdk-api-web3-api-docs-okx-wallet) - [错误码 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [介绍 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [错误码 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-defi-api-web3-api-docs-okx-wallet) - [快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [创建移动端 App 内通用链接 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-app-web3-api-docs-okx-wallet) - [交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [搭建限价单应用 | 快速开始 | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-dex-api-web3-api-docs-okx-wallet) - [资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-defi-api-web3-api-docs-okx-wallet) - [Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#fractal-ordinals-api-api-web3-api-docs-okx-wallet) - [链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [跨链 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-dex-api-web3-api-docs-okx-wallet) - [限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-dex-api-web3-api-docs-okx-wallet) - [快速开始 | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-dex-api-web3-api-docs-okx-wallet) - [API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#api-defi-api-web3-api-docs-okx-wallet) - [钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#runes-api-api-web3-api-docs-okx-wallet) - [Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#ordinals-api-api-web3-api-docs-okx-wallet) - [API 参考 | 兑换 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#api-api-dex-api-web3-api-docs-okx-wallet) - [API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#api-api-web3-api-docs-okx-wallet) - [概述 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-defi-api-web3-api-docs-okx-wallet) - [使用开发者管理平台 | 接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-web3-api-docs-okx-wallet) - [准备工作 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [查询支持的区块链 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [创建账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [REST API 鉴权 | 接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#rest-api-web3-api-docs-okx-wallet) - [Node.js 环境设置 | 接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#node-js-web3-api-docs-okx-wallet) - [更新账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [常用参数定义 | 资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [Javascript 签名 SDK | 签名 SDK | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#javascript-sdk-sdk-api-web3-api-docs-okx-wallet) - [Ordinals 相关模型 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#ordinals-ordinals-api-api-web3-api-docs-okx-wallet) - [提交挂单 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-runes-api-api-web3-api-docs-okx-wallet) - [查看 chainIndex | 资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-chainindex-api-web3-api-docs-okx-wallet) - [交易广播 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [Go 签名 SDK | 签名 SDK | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#go-sdk-sdk-api-web3-api-docs-okx-wallet) - [已经接入的市场 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [删除账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [搭建链上数据看板 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [搭建铭文钱包 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [错误码 | 资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [查广播订单列表 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [已部署合约 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [查询账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [查询账户下的地址 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [获取 Fractal Ordinals 合集列表 | Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-fractal-ordinals-fractal-ordinals-api-api-web3-api-docs-okx-wallet) - [获取合集信息 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-runes-api-api-web3-api-docs-okx-wallet) - [币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [错误码 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-dex-api-web3-api-docs-okx-wallet) - [限价单 | 介绍 | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-dex-api-web3-api-docs-okx-wallet) - [介绍 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [获取 Fractal Ordinals 交易历史 | Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-fractal-ordinals-fractal-ordinals-api-api-web3-api-docs-okx-wallet) - [搭建 Web3 钱包 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-web3-api-web3-api-docs-okx-wallet) - [获取热门合集 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-runes-api-api-web3-api-docs-okx-wallet) - [FAQ | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#faq-api-dex-api-web3-api-docs-okx-wallet) - [获取铭文资产列表 | Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-fractal-ordinals-api-api-web3-api-docs-okx-wallet) - [获取钱包资产 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-runes-api-api-web3-api-docs-okx-wallet) - [快速开始 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-ordinals-api-api-web3-api-docs-okx-wallet) - [获取 Ordinals 订单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-ordinals-ordinals-api-api-web3-api-docs-okx-wallet) - [获取订单信息 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-runes-api-api-web3-api-docs-okx-wallet) - [获取交易历史 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-runes-api-api-web3-api-docs-okx-wallet) - [智能合约 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-dex-api-web3-api-docs-okx-wallet) - [获取 Ordinals 交易历史 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-ordinals-ordinals-api-api-web3-api-docs-okx-wallet) - [与不同类型合约的交互 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [获取 Ordinals 合集列表 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-ordinals-ordinals-api-api-web3-api-docs-okx-wallet) - [查询铭文交易 | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [申购流程 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-defi-api-web3-api-docs-okx-wallet) - [已经接入的网络 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [领取奖励流程 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-defi-api-web3-api-docs-okx-wallet) - [交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [资产 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [赎回流程 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-defi-api-web3-api-docs-okx-wallet) - [获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [创建 Ordinals 挂单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-ordinals-ordinals-api-api-web3-api-docs-okx-wallet) - [用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [计算 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [NFT API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#nft-api-api-api-web3-api-docs-okx-wallet) - [查询用户的赎回申请列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [合集 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#api-api-dex-api-web3-api-docs-okx-wallet) - [API 参考 | 跨链 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#api-api-dex-api-web3-api-docs-okx-wallet) - [综合币价 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [签名所需数据 | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [实时币价 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [Gas Price | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#gas-price-api-web3-api-docs-okx-wallet) - [历史币价 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [Gas Limit | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#gas-limit-api-web3-api-docs-okx-wallet) - [项目信息 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [总估值 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [地址维度查询 | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [Nonce | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#nonce-api-web3-api-docs-okx-wallet) - [总估值 | 账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [账户维度查询 | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [资产明细 | 账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [SUI Object | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#sui-object-api-web3-api-docs-okx-wallet) - [查询赎回的预估计算信息 | 计算 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [查询网络列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [取消限价单 calldata | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-calldata-api-api-dex-api-web3-api-docs-okx-wallet) - [查询产品列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [取消订单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [查询限价单列表 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-dex-api-web3-api-docs-okx-wallet) - [查询代币列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [获取合集交易信息 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [查询用户的余额列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [查询产品详情 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [查询特定代币 | 账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [获取铭文资产列表 | 创建 Ordinals 挂单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-ordinals-ordinals-api-api-web3-api-docs-okx-wallet) - [地址校验 | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [查询限价单 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-dex-api-web3-api-docs-okx-wallet) - [查询特定代币 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [生成申购交易的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [创建限价单 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-dex-api-web3-api-docs-okx-wallet) - [订单相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [查询持有的 UTXO | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-utxo-api-web3-api-docs-okx-wallet) - [获取支持的链 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-dex-api-web3-api-docs-okx-wallet) - [创建挂单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [查询用户全网持仓列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [提交挂单 | 创建 Ordinals 挂单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-ordinals-ordinals-api-api-web3-api-docs-okx-wallet) - [查询协议列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [查询授权 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [获取 NFT 列表 | NFT API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-nft-nft-api-api-api-web3-api-docs-okx-wallet) - [查询用户协议维度持仓列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [生成赎回交易的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [生成交易前授权的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [获取合集详情 | 合集 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [获取合集列表 | 合集 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [资产相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [查询认购的预估计算信息 | 计算 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [查询挂单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [合集相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-web3-api-docs-okx-wallet) - [交易授权 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-dex-api-web3-api-docs-okx-wallet) - [获取币种列表 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-dex-api-web3-api-docs-okx-wallet) - [生成领取奖励金交易的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [查询用户投资品维度的持仓列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-defi-api-web3-api-docs-okx-wallet) - [获取资产列表 | 资产 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [查询特定 Tx | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-tx-api-web3-api-docs-okx-wallet) - [查询出价单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [查 UTXO 上铭文 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-utxo-api-web3-api-docs-okx-wallet) - [获取 NFT 详情 | NFT API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-nft-nft-api-api-api-web3-api-docs-okx-wallet) - [NFT 相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#nft-api-api-web3-api-docs-okx-wallet) - [获取授权额度 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-dex-api-web3-api-docs-okx-wallet) - [购买订单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-api-api-web3-api-docs-okx-wallet) - [资产明细 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet](#-api-web3-api-docs-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) - [OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet](#okx-okx-wallet) --- # 兑换 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-reference) [设置分佣](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-addfee) [Dex 集成](https://web3.okx.com/zh-hans/build/docs/waas/dex-integration) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-faq) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API 兑换 API 兑换 API[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation#%E5%85%91%E6%8D%A2-api) =============================================================================================== [API 参考\ \ 兑换 API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-reference) [智能合约\ \ 兑换 API 的智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-smart-contract) [错误码\ \ 兑换 API 的错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-error-code) [FAQ\ \ 兑换 API 兑换常见问题](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-faq) [搭建限价单应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-reference) --- # 什么是 OKX OS | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 介绍 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 介绍 什么是 OKX OS 什么是 OKX OS[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas#%E4%BB%80%E4%B9%88%E6%98%AF-okx-os) ===================================================================================================================== OKX OS 是一套完整的 Web3 开发解决方案，公链和协议的接入实现了标准化，极大地降低了开发周期和成本，包括钱包、DEX、Marketplace、DeFi 四大场景。 **OKX OS 拥有最强大的数据查询能力，深度解析资产、交易历史、项目信息等数据**。已支持 60+ 网络，包括 EVM、UTXO、Solana、TON、TRON 等热门网络，还支持铭文等最前沿的生态。 如果你希望搭建自己的 Web3 服务，采用 OKX OS 将是更高效、更经济的选择。 [![Wallet](https://web3.okx.com/cdn/assets/imgs/254/7A604E4A64E6D1EC.png)\ \ Wallet API\ \ 链上数据查询、钱包账户管理、交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [![DEX](https://web3.okx.com/cdn/assets/imgs/254/2A8894EB941D53F9.png)\ \ DEX API\ \ Swap、跨链、聚合多平台流动性](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [![Marketplace](https://web3.okx.com/cdn/assets/imgs/254/5E21BD4D53AEA16C.png)\ \ Marketplace API\ \ NFT 创作和交易、NFT 数据查询、聚合多平台流动性](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [![DeFi](https://web3.okx.com/cdn/assets/imgs/254/742DEDC0CF23E98A.png)\ \ DeFi API\ \ DeFi 信息查询、质押和赎回](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) 更多 Web3 工作流及基本原理，可以查看技术架构： [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) --- # 介绍 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API 介绍 介绍[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction#%E4%BB%8B%E7%BB%8D) ============================================================================================== 钱包 API 提供非托管钱包的底层技术方案，帮助你轻松构建链上服务和应用。 服务范围[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction#%E6%9C%8D%E5%8A%A1%E8%8C%83%E5%9B%B4) ------------------------------------------------------------------------------------------------------------------ 钱包 API 服务主要包含以下模块： **1\. 地址与钱包生成** **2\. 链上资产与币价信息查询** * 支持公链原生币种 (如以太坊上的 ETH) * 支持合约代币 (如 ERC-20、BEP-20) **3\. 交易管理** * 构建、签名、广播、追踪交易 * 查询交易历史 * 支持 EVM 等账户模型网络的交易 * 支持 BTC 等 UTXO 模型网络的交易 **4\. 其他常用数据查询** * 币种信息 * Gas 价格 * 地址授权信息 应用场景[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction#%E5%BA%94%E7%94%A8%E5%9C%BA%E6%99%AF) ------------------------------------------------------------------------------------------------------------------ 基于上述能力，你可以构建： **1\. Web3 多链钱包** * [支持 60+ 公链](https://web3.okx.com/zh-hans/build/docs/waas/wallet-supported-networks) **2\. DApp 内置钱包** **3\. 多链 Web3 应用** **4\. 交易所钱包服务** 如果你想使用我们的服务构建新的产品类别，欢迎来 [Discord](https://discord.gg/JBYgQxuyeu) 和我们交流。 [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) 目录 [服务范围](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction#%E6%9C%8D%E5%8A%A1%E8%8C%83%E5%9B%B4) [应用场景](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction#%E5%BA%94%E7%94%A8%E5%9C%BA%E6%99%AF) --- # 支持的网络 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 介绍 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 介绍 支持的网络 支持的网络[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks#%E6%94%AF%E6%8C%81%E7%9A%84%E7%BD%91%E7%BB%9C) ================================================================================================================================= OKX OS 支持行业内的大部分主流网络，可查看下方表格了解各个链的服务的具体支持情况。 EVM 网络[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks#evm-%E7%BD%91%E7%BB%9C) ----------------------------------------------------------------------------------------------------------- | 链 | Wallet API | DEX API | Marketplace API | DeFi API | | --- | --- | --- | --- | --- | | Ethereum Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | OP Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | BNB Smart Chain Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | OKT Chain | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | X layer | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Polygon Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Arbitrum One | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Avalanche C-Chain | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | zkSync Era Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Polygon zkEVM | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Base | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | | | Linea | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | | | Fantom Opera | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Mantle | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Conflux eSpace | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | | | Metis Andromeda Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | | | Merlin Chain | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | | | Blast | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-startn) | | | | Manta Pacific Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | opBNB Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chaint) | | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Kaia Network (Klaytn Mainnet Cypress) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | | | Arbitrum Nova | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | | | Scroll | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) | | | Gnosis | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | Core Blockchain Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) | | B^2 network | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Kroma | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Flare Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Cronos Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | | | Ethereum Classic | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Immutable zkEVM | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | KCC Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | PulseChain | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Omega Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Endurance Smart Chain Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Moonbeam | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Moonriver | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Ronin Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Rangers | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Mode network | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Taiko network | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Bitlayer network | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Bob network | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Kava EVM | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | EthereumPoW | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Celo Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Ethereum Fair（DIS Chain） | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Gravity | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Wemix | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Lumi | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Sepolia | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | ZetaChain Mainnet | | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | | | Sonic | | [已支持兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | | UTXO 网络[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks#utxo-%E7%BD%91%E7%BB%9C) ------------------------------------------------------------------------------------------------------------- | 链 | Wallet API | DEX API | Marketplace API | DeFi API | | --- | --- | --- | --- | --- | | Bitcoin Mainnet | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | [支持铭文市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) | | | Fractal Bitcoin Mainnet | [暂不支持交易广播相关能力，其他均支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) | | [支持铭文市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) | | | Litecoin | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Doge | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | Dash | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | | BCH | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | | | | 其他网络[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks#%E5%85%B6%E4%BB%96%E7%BD%91%E7%BB%9C) ----------------------------------------------------------------------------------------------------------------------- | 链 | Wallet API | DEX API | | --- | --- | --- | | Tron | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | Solana | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | SUI | [已支持](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) | [已支持兑换及跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | | Ton | 即将上线 | [已支持兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) | [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) 目录 [EVM 网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks#evm-%E7%BD%91%E7%BB%9C) [UTXO 网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks#utxo-%E7%BD%91%E7%BB%9C) [其他网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks#%E5%85%B6%E4%BB%96%E7%BD%91%E7%BB%9C) --- # 介绍 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API 介绍 介绍[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction#%E4%BB%8B%E7%BB%8D) ========================================================================================= 欧易 Web3 DeFi 是市场上领先的 DeFi 投资聚合平台。 我们的多链 DeFi 聚合器能够为用户提供了一个可聚合市场上各类 DeFi 投资机会的多功能平台，从而方便用户快速精准地找到符合他们需求的投资产品。 欧易 Web3 DeFi 目前已接入 **80 多项协议**，包括 Aave、Compound、Curve、Yearn 和 Uniswap。我们还支持超过 15 个网络，如 Arbitrum、Ethereum 和 Polygon。 将欧易 Web3 DeFi Open API 集成到你的应用中，会使你的用户轻松快速地访问所有 DeFi 协议，并在投资 DeFi 的过程中享受赚币乐趣。 [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) --- # 申请 DApp 入驻 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 更多资源 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 更多资源 申请 DApp 入驻 申请 DApp 入驻[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application#%E7%94%B3%E8%AF%B7-dapp-%E5%85%A5%E9%A9%BB) ============================================================================================================================================ 一直以来，无法通过 Google 等搜索引擎准确、高效地搜索 DApp 严重影响了 Web3 用户的使用体验。为了解决这个问题，欧易 Web3 钱包内置了搜索功能，并接入各类热门 DApp 产品，让用户可以更精准地搜索、更轻松地使用 DApp。 欧易 Web3 钱包发现，旨在成为您探索 Web3 世界的首选入口。 如需入驻 Discover 请提交 [build with us](https://forms.gle/kLwVFevWXBjRa6WC6) ， 如需设置广告位，请联系 [wallet@okx.com](mailto:wallet@okx.com) 。 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) --- # 接口规范 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 更多资源 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 更多资源 接口规范 接口规范[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard#%E6%8E%A5%E5%8F%A3%E8%A7%84%E8%8C%83) ============================================================================================================= 响应结构体[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard#%E5%93%8D%E5%BA%94%E7%BB%93%E6%9E%84%E4%BD%93) ----------------------------------------------------------------------------------------------------------------------- **成功** { "code": 0, // success code "msg": "success", // success message "data": [] } **失败** { "code": 1, // error code "msg": "error", // error message } [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) 目录 [响应结构体](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard#%E5%93%8D%E5%BA%94%E7%BB%93%E6%9E%84%E4%BD%93) --- # 接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [使用开发者管理平台](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) [REST API 鉴权](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 介绍 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 介绍 接入前提 接入前提[#](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard#%E6%8E%A5%E5%85%A5%E5%89%8D%E6%8F%90) ========================================================================================================================= 本章节介绍了接入 OKX OS 的前提步骤，以及鉴权和环境配置 [使用开发者管理平台\ \ 创建你的项目以及 API Key](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) [REST API 鉴权\ \ 使用 REST 请求的注意事项](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) [Node.js 环境设置\ \ 使用 Node.js 开发的环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) 若想了解接口规范相关内容，请参考[更多资源](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) 。 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [使用开发者管理平台](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) --- # 更新日志 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 更多资源 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 更多资源 更新日志 更新日志[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97) ===================================================================================================== ### 2025年3月12日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2025%E5%B9%B43%E6%9C%8812%E6%97%A5) **API/DEX API**Update * 单链兑换已支持 Sonic 链 ### 2025年3月6日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2025%E5%B9%B43%E6%9C%886%E6%97%A5) **API/DEX API**Update * 单链兑换接口已支持收取正滑点，你可通过设置`enablePositiveSlippage`参数来实现 ### 2025年2月11日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2025%E5%B9%B42%E6%9C%8811%E6%97%A5) **API/DEX API**Update * 单链兑换接口已支持 Solana 链的/swap-instruction接口，你可自定义组装交易指令 ### 2025年1月23日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2025%E5%B9%B41%E6%9C%8823%E6%97%A5) **API/DEX API**Update * 单链兑换接口已支持指定单个流动性池进行兑换的功能，你可通过设置`directRouter`参数来实现，当前仅支持 Solana 链 * 单链兑换接口已支持查询兑换交易历史功能 ### 2024年12月26日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B412%E6%9C%8826%E6%97%A5) **API/DEX API**Update * 单链兑换接口已支持自动滑点功能 ### 2024年11月25日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B411%E6%9C%8825%E6%97%A5) **API/DEX API**Update * 单链兑换接口 swapReceiverAddress 参数已支持 Solana 链，现在可以在 Solana 链，为一笔兑换交易指定其他接收地址 ### 2024年11月12日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B411%E6%9C%8812%E6%97%A5) **API/DEX API**Update * 单链兑换接口增加 Solana 新分佣地址入参参数，Sol 及 SPL token 均支持直接使用钱包地址分佣 * 获取单链流动性列表及获取跨链桥列表接口，支持返回协议 logo 内容 * 单链询价、兑换接口，支持识别并返回貔貅盘，买卖税 100% 的风险代币 ### 2024年10月29日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B410%E6%9C%8829%E6%97%A5) **API/DEX API**Update * 单链兑换支持 Sui 链 ### 2024年7月2日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B47%E6%9C%882%E6%97%A5) **API/DEX API**Update * ETH dexRouter 合约 0xf3de3c0d654fda23dad170f0f320a92172509127 在 2024 年 8 月 1 日后将无法正常使用，请使用最新版本。 ### 2024年6月19日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B46%E6%9C%8819%E6%97%A5) **API/DEX API**Update * 兑换 API DEX Router eth 合约地址更新 ### 2024年5月7日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B45%E6%9C%887%E6%97%A5) **API/DEX API**Update * Solana 主网支持分佣功能 ### 2024年4月19日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B44%E6%9C%8819%E6%97%A5) **API/DEX API**Update * 跨链支持 SUI 链 ### 2024年4月19日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B44%E6%9C%8819%E6%97%A5) **API/DEX API**Update * 跨链支持 X Layer 链 ### 2024年4月12日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B44%E6%9C%8812%E6%97%A5) **API/DeFi API**Update * 跨链滑点限制请求参数范围调整为0.002-0.5 * 跨链支持Merlin链 ### 2024年4月12日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B44%E6%9C%8812%E6%97%A5) **API/DeFi API**Update * 更新 单链兑换接口, 新增返回参数（quoteCompareList） ### 2024年4月8日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B44%E6%9C%888%E6%97%A5) **API/DeFi API**Update * 更新 单链兑换接口, 新增请求参数（toTokenReferrerAddress） ### 2024年4月2日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B44%E6%9C%882%E6%97%A5) **API/DeFi API**Update * 更新 单链兑换接口, 新增支持链（Merlin） ### 2024年3月22日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B43%E6%9C%8822%E6%97%A5) **API/DeFi API**Update * 更新 单链兑换接口, 新增请求参数（callDataMemo） ### 2024年3月22日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B43%E6%9C%8822%E6%97%A5) **API/DeFi API**Update * 向 DEX 跨链获取路径信息接口和跨链兑换接口增加了新的请求参数 （sort) * DEX XBridge 合约地址更新 ### 2024年3月13日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B43%E6%9C%8813%E6%97%A5) **API/DeFi API**Update * 向 DEX 跨链查询交易状态接口增加了新的响应参数 （sourceChainGasfee, destinationChainGasfee, crossChainFee) * 向 DEX 跨链兑换接口增加了新的请求参数（onlyBridge）以及新的响应参数（minmumReceive, maxPriorityFeePerGas） * 跨链兑换 API 智能合约部分新增跨链合约地址 （DEX XBridge 合约地址） * 跨链兑换 API 新增获取仅通过跨链桥交易的币种列表接口 ### 2024年3月7日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B43%E6%9C%887%E6%97%A5) **API/DeFi API**Update * 更新 单链跨链兑换接口, 新增请求参数（priceImpactProtectionPercentage） ### 2024年2月29日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B42%E6%9C%8829%E6%97%A5) **API/DeFi API**Update * 更新 单链兑换接口, 新增返回参数（decimal） ### 2024年2月22日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B42%E6%9C%8822%E6%97%A5) **API/DeFi API**Update * 更新 单链兑换接口, 新增返回参数（maxPriorityFeePerGas） ### 2024年2月1日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B42%E6%9C%881%E6%97%A5) **API/DeFi API**Update * 更新 单链兑换接口 支持 solana, 新增请求参数（solTokenAccountAddress） * 新增 单链兑换 支持 solana 快速开始引导 ### 2024年1月17日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B41%E6%9C%8817%E6%97%A5) **API/DeFi API**Update * 向 DEX 跨链兑换接口增加了新的请求参数（feePercent, referrerAddress) ### 2024年1月11日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B41%E6%9C%8811%E6%97%A5) **API/DeFi API**Update * 跨链滑点范围调整为0.005-0.5 ### 2024年1月2日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2024%E5%B9%B41%E6%9C%882%E6%97%A5) **API/DeFi API**Update * 向 DEX 跨链兑换接口增加了新的请求参数（receiveAddress) * 向 DEX 跨链查询交易状态接口增加了新的请求参数（chainld) ### 2023年12月28日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B412%E6%9C%8828%E6%97%A5) **API/DeFi API**Update * 上线欧易 Web3 DeFi 首版 API 文档 * 新增接入 DeFi API 的申购、赎回以及领取奖励金流程 * 新增查询信息、计算预估信息、调用交易数据、查询用户信息的方法 ### 2023年12月20日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B412%E6%9C%8820%E6%97%A5) **API/DEX API**Update * 向 DEX 跨链兑换获取路径信息接口和跨链兑换接口增加了新的响应参数（crossChainFeeTokenAddress） * 向 DEX 跨链兑换查询交易状态接口增加了新的响应参数（status） ### 2023年12月14日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B412%E6%9C%8814%E6%97%A5) **API/DEX API**Update * 新增 Dex Iframe ### 2023年12月14日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B412%E6%9C%8814%E6%97%A5) **API/DEX API**Update * 向 DEX 交易接口增加了新的可选参数（swapReceiverAddress） ### 2023年12月08日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B412%E6%9C%8808%E6%97%A5) **API/DEX API**Update * 新增 DEX 限价单列表查询接口 * 新增 DEX 限价单获取取消calldata ### 2023年12月06日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B412%E6%9C%8806%E6%97%A5) **API/DEX API**Update * 向 DEX 跨链兑换获取路径信息接口增加了新的响应参数（toDexRouterList） * 向 DEX 跨链兑换查询交易状态接口增加了新的响应参数（toAmount, errorMsg） * 向 DEX 跨链兑换 FAQ 增加了跨链退款问题 ### 2023年11月24日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B411%E6%9C%8824%E6%97%A5) **API/DEX API**Update * Order API 新增挂单模块，支持挂单到 OpenSea 和 OKX * Order model 模型增加更多字段的解释 ### 2023年11月23日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B411%E6%9C%8823%E6%97%A5) **API/DEX API**Update * 增加了DEX 跨链聚合器 API 快速开始教程 ### 2023年11月21日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B411%E6%9C%8821%E6%97%A5) **API/DEX API**Update * 增加了DEX 跨链聚合器 API 快速开始教程 ### 2023年11月15日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B411%E6%9C%8815%E6%97%A5) **API/DEX API**Update * 向 DEX 跨链聚合器获取路径信息接口 cross-chain/quote 添加了新的响应参数 （crossChainFee) * 向 DEX 跨链聚合器跨链兑换接口 cross-chain/build-tx 添加新的响应参数（crossChainFee） ### 2023年11月10日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B411%E6%9C%8810%E6%97%A5) **API/DEX API**Update * 增加了DEX API 快速开始教程 ### 2023年11月7日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B411%E6%9C%887%E6%97%A5) **API/DEX API**Update * 增加了 DEX 跨链聚合器 API ### 2023年10月31日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B410%E6%9C%8831%E6%97%A5) **API/DEX API**Update * 添加了 DEX 限价单 API ### 2023年10月23日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B410%E6%9C%8823%E6%97%A5) **API/DEX API**Update * 添加了智能合约模块，包含合约地址信息及合约ABI ### 2023年9月27日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B49%E6%9C%8827%E6%97%A5) **DApp 接入钱包文档升级**Update * 更新了 DApp 接入欧易 Web3 钱包移动端的内容 * 添加了 DApp 接入欧易 Web3 钱包移动端的引导和内容 * * * ### 2023年8月17日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B48%E6%9C%8817%E6%97%A5) **API/Marketplace API**Update * 添加了 API key 的身份验证。此后的所有接口都需要从 Web3 开发者管理平台生成 API key * 根据最新版本更新了所有 URI * 更新了错误码 **API/DEX API**Update * 添加了 API key 的身份验证。此后的所有接口都需要从 Web3 开发者管理平台生成 API key * 更新了错误码 **API/比特币生态**Update * 添加了 API key 的身份验证。此后的所有接口都需要从 Web3 开发者管理平台生成 API key * 根据最新版本更新了所有 URI * * * ### 2023年5月29日[#](https://web3.okx.com/zh-hans/build/docs/waas/changelog#2023%E5%B9%B45%E6%9C%8829%E6%97%A5) **API/比特币生态**Update * 添加了新的 BRC-20 接口：`brc20/token-list` * 向 BRC-20 接口 `brc20/transaction-list` 添加了新的响应参数（ index, location ） * 在 BRC-20 接口 `brc20/inscriptions-list` 添加了新的响应参数（ location ） * * * [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) --- # OKX Web3 Build 用户协议 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 更多资源 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 更多资源 OKX Web3 Build 用户协议 OKX Web3 Build 用户协议[#](https://web3.okx.com/zh-hans/build/docs/waas/legal#okx-web3-build-%E7%94%A8%E6%88%B7%E5%8D%8F%E8%AE%AE) =============================================================================================================================== 最近更新日期：2023 年 11 月 28 日 本[OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/help/okx-web3-build-user-agreement) （“本协议”）构成您 - 作为开发者（“开发者”、“用户”或“您”）与 OKX Technology Services Pte. Ltd. （“我们”、“我们的”或“OKX”） 以及我们的任何关联方之间关于您使用 OKX Web3 Build服务的协议（合称“本服务”）。 通过使用本服务，您确认您已阅读、理解并接受本协议、[OKX Web3生态系统服务条款](https://web3.okx.com/zh-hans/help/okx-web3-ecosystem-terms-of-service) (“服务条款”)、[OKX Web3 生态系统隐私政策](https://web3.okx.com/zh-hans/help/okx-web3-ecosystem-privacy-policy) 以及任何和所有其他规则或政策，并且无论您所处区域、国籍和/或使用的服务，您均应受任何和全部该等条款和条件的法律约束。如果您不同意受本协议约束，请勿访问或使用本服务。 本协议应补充服务条款。 如果本协议中规定的任何条款或规定与服务条款发生任何冲突或不一致，应通过优先考虑本协议来解决此类冲突或不一致。服务条款中未被本协议修改的所有其他规定仍具有完全之效力。 OKX 可能会不时提供单独的用户条款和许可，这些条款和许可可以补充本协议，但作为提供服务的本协议不可分割的一部分。 1. 本服务 1.1 本服务。 本服务为开发者提供各种工具、产品和服务，以构建和创建个性化的 Web3 生态系统、产品和/或服务。 用户将能够通过第三方区块链连接他们的数字钱包，构建自己的去中心化应用程序和编程，这些应用程序和编程在区块链技术或点对点网络（“Dapps”）上存在和运行。本服务通过应用程序编程接口（“API”）提供与钱包、流动性和链上数据的 Web3 基础设施相关的各种功能。部分服务可能以软件开发工具包（“SDK”）的形式提供。 然而，OKX 仅提供用户连接工具的接口，并不参与通过服务进行的任何交易。 本服务为开发者提供了完备的 Web3 基础设施开发套件，从钱包集成、交易流动性到链上数据方案 ，帮助开发者开发和构建他们的 Dapp 以及其他产品和服务。本服务仅提供予开发者使用，不得用于重新分发、转售或本协议范围之外的任何其他目的。 1.2 服务详情。 该服务聚合了以下工具和 API，供用户访问和构建其 Web3 生态系统、产品和服务： Web3 基础设施套件； WaaS 解决方案； 流动性解决方案； 以太坊二层扩展方案；及/或 OKX 不时提供的其他工具和解决方案； OKX 亦提供了一组一站式开发者管理平台，作为简化的 API 管理和监控中心，以实现无缝控制和优化。 1.3 API、SDK 和解决方案。 本服务下提供的每组 API、SDK 和解决方案均应遵守单独的 API 文档、用户条款和条件、最终用户许可证等，以供用户访问和使用，OKX 应不时提供这些文档。 为了访问和使用 API，您创建的用于生成和访问 API 密钥的密码对您来说是保密的，OKX 无法访问。 如果您丢失密码，您将无法访问 API 密钥。 您同意并承诺对您的密码和API密钥严格保密，不与任何第三方共享。 您同意您将对 API 密钥的使用和密码的安全承担全部责任。 1.4 使用数字钱包。为使用本服务，您可能必须连接数字钱包（例如 OKX Web3 钱包）。您对在本服务过程中使用数字钱包可能产生的任何损失承担全部责任。 OKX 无法访问您的数字钱包登录凭据和身份验证信息，我们不会保留或维护该等文件、密码、助记词和/或私钥。 此外，由于 OKX 可能无法访问您的数字钱包，对于由您的数字钱包执行或涉及您的数字钱包的任何交易，OKX 不承担任何责任，而您应自行承担全部负责，无论您是否批准该等交易。 1.5 密码和私钥。数字钱包可能具有区块链技术的各种去中心化特性。这些去中心化服务不同于银行金融机构。您理解并接受 OKX 不对以下事项负责： 存储您的安全密码（即您在创建或导入钱包时设置的密码）；私钥和助记词；恢复您的安全密码、私钥或助记词；冻结您的钱包，报告丢失钱包；恢复您的钱包；或维护或访问您的钱包所需的其他操作。请妥善保管所有这些，因为如果您无法获取这些，将阻止您访问您的钱包以及您可能拥有的任何数字资产或其他资金。 1.6 使用的目的和合法性。您同意您仅将本服务用于合法目的，并且您不得使用本服务来规避遵守适用法律或将本服务用于任何非法、侵入、误导或欺诈目的。 在使用本服务时，您有责任了解并遵守您所在国家或地区的法律。 您还同意遵守 OKX 不时发布和更新的所有规则、条款以及任何其他通知或相关协议，包括公告、程序说明、风险披露以及其他规则和条款。 1.7 原型。您同意并接受本服务依赖于新兴技术。 由于您可能滥用公钥/私钥密码学等内容，或未能正确更新或运行软件以适应协议升级，本服务可能会面临更大的风险。 使用本服务即表示您明确确认并接受该等增加的风险。 2. 服务费 2.1 矿工费。在您访问和使用服务的过程中，您可能会产生各种矿工费。在本服务下在任何第三方区块链上产生的矿工费用将由您承担及支付。 2.2 第三方协议费用。在您访问和使用服务期间，可能还会产生其他第三方协议费用，包括但不限于您转移数字资产。您全权负责支付任何和所有可能产生的第三方协议费用。 2.3 服务费。请注意，OKX 目前不收取任何服务费，但我们保留将来向您收取服务费的权利。OKX 可能会就向您提供本服务向您收取一定的服务费。任何服务费用表应不时在 OKX 平台上公布，OKX 保留自行决定更新此类费用表（如有）的权利。 3. 所有权 3.1 概述。本服务包含来自第三方平台的信息和链接，该等信息和链接将用户指向至网页、网页应用程序、移动应用程序、应用程序界面或链接到第三方平台的网页和移动应用程序的任何关联站点。 3.2 有限使用权。OKX 不对您通过本服务提供的任何内容（“用户内容”）主张任何所有权。 您同意您拥有您提供给我们的任何用户内容的所有权利、所有权和利益，包括所有知识产权。 您特此授予 OKX 全球免版税许可，以使用、复制和展示您在访问和使用本服务时或通过访问和使用本服务上传、提交、存储和/或发送的任何用户内容（其中可能包括关于您已同意创建或使用的任何权利）。 3.3 知识产权。 在 OKX 向您提供服务期间，您可以通过本服务访问 OKX 的专有信息和知识产权，以及可能包含受版权保护的作品、专有技术、可专利信息、机密信息等的任何材料。 OKX 指定仅供您作为开发者根据本协议和任何其他 API 文档、用户条款和条件、最终用户许可和说明创建和使用在您的项目、产品和服务的其他内容之目的。 未经 OKX 事先书面批准，您不得将此类材料或信息用于重新分发、转售或任何其他目的。 3.4 OKX 商标和知识产权。 OKX 的商标（包括但不限于“OKX”、“OKX 徽标”、“X 徽标”商标）、服务标记、商业外观、徽标以及 OKX 商品或服务来源的任何其他标记（“OKX 商标”）和知识产权均为 OKX 及其附属公司的财产。 您使用与服务相关的 OKX 商标的有限权利并不赋予您与 OKX 商标相关的任何权利、所有权或所有权权益。 您因使用与本协议相关的目的而产生的所有商誉将确保 OKX 的唯一且排他的利益。 OKX 保留随时自行决定终止您使用 OKX 商标或任何知识产权的许可的权利。 4. 额外风险披露 4.1 不保证具体时间。您理解并同意，当用户赎回或访问其数字资产时，用户在数字钱包中收到数字资产的实际时间可能会有所不同，并且用户的数字钱包上收到和显示的数字资产应是最终的。 OKX 不对因上述造成的任何损失承担责任。 4.2 责任限制。您理解并同意 OKX 的全部责任不超过 OKX 从您那里收到的服务费。 4.3 协议的修改。您理解并同意 OKX 保留不时自行修改本协议内容的权利。 OKX 不对基于您对本协议的错误理解或您延迟阅读本协议的任何修改或更新而造成的任何损失承担责任。 4.4 地址错误。 OKX 不对因将数字资产发送到错误地址而造成的任何损失负责。您应确保将您的数字资产存入 OKX 指定的正确地址，以接收您拟通过使用本服务转移至第三方区块链的数字资产。您应提供正确的数字钱包地址，以接收您拟通过本服务从第三方区块链转移来的数字资产。 OKX不对因您自己的过错或错误导致的任何及所有损失承担责任，包括但不限于：您提供的数字钱包地址或其他接收数字资产的地址不正确，或您将资产转移到错误的地址。 4.5 用户过错或错误。您同意承担因您自身的过错或错误而造成的任何及所有损失，包括但不限于：未按照交易提示操作、未及时进行交易、将您的数字资产转移至错误的第三方区块链或错误的地址，忘记或泄露密码和/或私钥，破解密码，您的计算机被他人入侵或黑客攻击，和/或输入错误的地址以转移或接收数字资产。 4.6 第三方内容和服务。您理解并同意，当您使用本服务时，您可能会访问和使用第三方区块链。 OKX 不对您使用或访问第三方区块链造成的任何及所有损失负责。您理解并同意 OKX 对任何第三方区块链授予访问权限。 OKX仅提供项目展示、收益分配等相关服务。 OKX不对基于下述造成的任何损失负责：合约漏洞；黑客事件；暂停、终止或终止业务；破产；异常暂停；或第三方区块链运营停止或其他潜在风险。此外，您同意承担因上述风险而可能遭受的任何及所有损失。如果您因上述风险而遭受任何损失，您理解并同意存储在您数字钱包中的任何数字资产都可能会永久丢失。 本服务还可能包含访问或使用第三方网站（“第三方网站”）和应用程序（“第三方应用程序”）的链接或功能，或以其他方式显示、包含或提供内容、数据、信息、服务、应用程序或来自第三方的材料（“第三方材料”）。 本服务中的任何第三方网站链接并不代表OKX认可其中提供的任何产品、服务、信息和免责声明，OKX不保证其中所含信息的准确性。当您点击第三方网站或第三方应用程序的链接或访问和使用第三方网站或第三方应用程序时，虽然我们可能不会警告您您已离开我们的服务，但您仍需遵守其他网站或目的地的条款和条件（包括隐私政策）。此类第三方网站、第三方应用程序和第三方材料不受 OKX 的控制，并且可能是无法追索的“开放”应用程序。 OKX 不对任何第三方网站、第三方应用程序和第三方材料负责。 OKX 提供这些第三方网站和第三方应用程序的链接只是为了方便用户，就第三方网站或第三方应用程序或其产品或服务或相关的第三方材料，OKX并不审查、批准、监控、认可或做保证。您使用第三方网站、第三方应用程序和第三方材料中的所有链接，风险自负。对于您在第三方网站和第三方应用程序上使用此类第三方产品和服务而造成的任何损失，OKX 概不负责。 OKX与各第三方网站、第三方应用程序均为独立的法人实体，本协议不构成双方之间任何形式的代理、合伙或合作关系。 OKX与各第三方网站、第三方应用程序因履行各自的合同、协议而产生的债权、债务和纠纷均由其自行负责。 4.7 第三方区块链故障。您理解并同意，因下述情况导致OKX平台或第三方区块链无法正常运行或服务中断，且您无法使用服务或无法发出指令或进行相关交易操作，包括但不限于故障、延迟、中断、缺乏系统响应、延迟系统响应或任何其他异常和/或意外情况，OKX不对任何损失承担责任。这些情况包括但不限于 第三方区块链暂停、终止和/或终止其业务；关闭；和/或异常暂停或终止服务； 第三方平台或OKX公布的因维护而暂停服务； 系统不能传输数据； 导致第三方区块链暂停的不可抗力事件； 因黑客攻击、电脑病毒、技术调整或故障、网站升级、银行问题、因政府规定临时关闭等原因导致第三方区块链服务中断或延迟等; 第三方区块链因其计算机系统损坏、有缺陷或无法正常运行而导致的服务中断或延迟； 行业现有技术无法预测或解决的技术问题所造成的损失； 您或其他第三方因第三方的过错或延误而遭受的损失； 您或其他第三方因法律、法规和/或政府命令的变化而遭受的损失； 您或其他第三方因不可预见、不可避免和/或无法解决的客观情况造成的不可抗力事件而遭受的损失。 您理解并同意上述原因可能导致交易异常、价格波动、市场波动、市场中断等可能出现的异常情况。您还理解，此处的风险披露声明不是也不可能是全面的或详尽的。 OKX 可能会根据实际情况拒绝执行您的命令。此外，您理解并同意，OKX不对因上述任何情况引起的或与之相关的任何损失承担责任。 4.8 由于您缺乏资格而导致的损失。您理解并接受，OKX 不对基于您访问或使用本服务的资格相关的任何风险而造成的任何损失承担责任。 5. 禁止行为 5.1 禁止不公平的交易行为。您理解并同意 OKX 严格禁止不公平交易行为。如果您在访问或使用我们的服务时执行或被合理怀疑正在执行下述操作，OKX 保留拒绝、暂停或终止向您提供我们的服务的权利： 参与市场操纵、价格操纵、内幕交易、市场扭曲、任何其他恶意的市场行为或任何其他恶意的市场行为; 可能通过利用本服务的漏洞或其他不合理的手段损害其他用户或OKX; 参与OKX认为对市场有害的任何其他活动； 参与违反任何法律法规的活动; 为了消除任何对市场整体健康的不利影响，OKX保留自行决定采取以下措施的权利，包括但不限于关闭您的账户，限制或取消指令。您了解并同意OKX对因采取上述措施而给您带来的任何损失（包括但不限于任何直接或间接损失、实际损失或可得利益损失等任何损失）不承担任何责任。 5.2 OKX 的权利。为了尽量减少和/或消除对整体市场的任何不利影响，OKX 保留自行决定采取以下措施的权利，包括但不限于暂停或关闭您的帐户、限制或取消您的命令、与相关司法和/或监管机构联系和合作。您理解并同意，OKX不对您因上述措施可能导致的任何损失（包括但不限于任何直接或间接损失、实际损失或可能利润的损失）承担责任。 6. 保证 6.1 一般原则。除非 OKX 以书面形式明确另有表示，OKX 及其关联公司或供应商不对您作出任何形式的陈述、保证或担保。OKX 及其服务、其中包含的内容以及其中列出的数字资产均严格按“原样”和“现有”提供，无论地点，均不提供任何形式的明示或暗示的保证或条件，且不限制前述一般意图。 7. 责任限制和赔偿 对于与您使用本服务、您违反本协议、您购买、出售数字资产或其他OKX服务相关之使用有关的任何第三方索赔或与之相关的任何损失，您将赔偿、保护OKX、我们的关联公司以及我们和他们各自的高级职员、董事、员工和代理人，并使他们免受损害。 OKX 与本协议相关的总责任不得超过以下两者中的较大者 (a) 100 美元或 (b) OKX 在导致责任的事件发生前 12 个月内从您那里收到的费用。OKX 不对任何间接的、惩罚性的、特殊的、偶然性或后果性的损害承担任何责任，无论这些损害是如何产生的（包括律师费以及诉讼和仲裁的所有相关成本和费用，或者在审判或上诉中，如有，无论是否提起诉讼或仲裁），无论是在合同诉讼、疏忽或其他侵权诉讼中，包括但不限于因本协议或任何联邦、州或地方法律、法规、规则或规定引起的任何人身伤害或财产损失索赔，即使 OKX 之前已被告知此类损害的可能性。某些司法管辖区不允许排除或限制此类损害，因此先前的限制或排除可能不适用于您。 8. 适用法律 8.1 一般。本协议、您对本服务的使用、任何由本协议直接或间接引起的任何种类或性质的索赔、反索赔或争议，均应受英格兰和威尔士的法律管辖并按其解释，不考虑其法律冲突原则。 9. 管辖权和争议解决 9.1 争议解决方法。您承认并同意，在发生任何争议时，双方应首先根据当时有效的香港国际仲裁中心（“HKIAC”）将争议提交至HKIAC进行仲裁。 9.2 仲裁规则和管辖权。如果争议在提交第9.1条规定的调解请求后九十 (90) 天内签署和解协议后仍未解决，则该争议应根据提交仲裁通知时生效的香港国际仲裁中心机构仲裁规则提交香港国际仲裁中心仲裁并最终解决。本仲裁条款适用中华人民共和国香港特别行政区（“香港”）法律。除非当事人另有约定，任何现场仲裁听证会的地点应为香港。 9.3 仲裁席位和语言。您同意仲裁地为香港。仲裁员人数应为三（3）名。OKX应指定一 (1) 名仲裁员，您应指定一 (1) 名仲裁员。 第三名仲裁员由香港国际仲裁中心主席指定。此类仲裁员应自由选择，当事人的选择不限于任何规定的名单。任何仲裁程序均应以英语进行。 9.4 有限的取证权。您同意 OKX 不被要求提供一般文件的发现，而可能只被要求提供与争议结果相关且重要的特定且已识别的文件。 9.5 终局性和约束性。任何仲裁裁决均为终局裁决，对双方具有约束力，并可在任何有管辖权的法院强制执行。 9.6 没有集体诉讼或诉讼。您同意通过仲裁单独解决与 OKX 的任何和所有争议，而不是作为任何集体诉讼或代表诉讼的一部分。 9.7 保密。当事人同意对仲裁进行保密。除仲裁庭、香港国际仲裁中心、当事人以及他们的律师、专家、证人、会计师和审计师、保险人和再保险人，以及进行仲裁所需的任何其他人，仲裁的存在、仲裁中提供的任何非公开信息以及仲裁中作出的任何提交、命令或裁决（统称为“保密信息”）均不得向任何非当事人披露。尽管有上述规定，但在履行法律义务、保护或追求合法权利或在善意法律程序中执行或质疑裁决可能需要披露的范围内，一方可以披露机密信息。本保密条款应在本协议和根据本协议提起的任何仲裁终止后继续有效。 10. 一般规定 10.1 接受所有条款和条件。通过使用本服务，您同意您已阅读、理解并接受本协议以及与本服务相关的所有相关交易和操作规则，并且您同意受本协议条款和条件的法律约束。OKX保留随时自行决定更改或修改本协议的权利，并将通过在网站上发布修订后的协议并更改此处的“最近更新”日期来提供此类更改的通知。另请仔细阅读第三方平台上发布（并不时修订）的所有服务条款、隐私政策以及相关的交易和操作规则。只有在您阅读、理解并同意所有相关规则后，方可访问及使用本服务。另请仔细阅读第三方平台上发布的所有服务条款、隐私政策以及相关交易和运营规则（不时修订）。只有在您阅读、理解并同意所有相关规则及政策后，才能访问及使用本服务。 10.2 语言。如果本协议内容与其他语言的翻译版本的内容存在冲突，以英文版的本协议内容为准。本协议的最终解释权归OKX所有。 [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) --- # 签名 SDK | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [Javascript 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk) [Go 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API 签名 SDK 签名 SDK[#](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk#%E7%AD%BE%E5%90%8D-sdk) ================================================================================================= [Javascript 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk) [Go 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [Javascript 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk) --- # 错误码 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API 错误码 错误码[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code#%E9%94%99%E8%AF%AF%E7%A0%81) ======================================================================================================== | 错误码 | HTTP 状态 | 提示信息 | | --- | --- | --- | | 0 | 200 | 操作成功 | | 50011 | 429 | 用户请求频率过快，超过该接口允许的限额。请参考 API 文档并限制请求 | | 50014 | 400 | 必填参数 {param0} 不能为空 | | 50026 | 500 | 系统错误，请稍后重试 | | 50103 | 401 | 请求头“OK\_ACCESS\_KEY“不能为空 | | 50104 | 401 | 请求头“OK\_ACCESS\_PASSPHRASE“不能为空 | | 50105 | 401 | 请求头“OK\_ACCESS\_PASSPHRASE“错误 | | 50106 | 401 | 请求头“OK\_ACCESS\_SIGN“不能为空 | | 50107 | 401 | 请求头“OK\_ACCESS\_TIMESTAMP“不能为空 | | 50111 | 401 | 无效的OK\_ACCESS\_KEY | | 50112 | 401 | 无效的OK\_ACCESS\_TIMESTAMP | | 50113 | 401 | 无效的签名 | | 83000 | 200 | 数据不存在 | | 83001 | 200 | 错误的请求参数 | | 83002 | 200 | 不支持的链 | | 83003 | 200 | \[createTime,updateTime\]时间范围存在冲突 | [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) --- # 介绍 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API 介绍 介绍[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E4%BB%8B%E7%BB%8D) ================================================================================================ 欢迎浏览欧易 NFT 市场的开发者文档，欧易 NFT 市场是一个一站式去中心化 NFT 聚合交易平台，支持多链 NFT 创作与跨平台交易，可以为用户和开发者提供实时链上数据，致力于去中心化、多链的 NFT 生态构建。 NFT 聚合器[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#nft-%E8%81%9A%E5%90%88%E5%99%A8) ------------------------------------------------------------------------------------------------------------------ 欧易 NFT 市场汇集了多个主流市场和平台的订单深度，能够为开发者及用户提供最及时的订单数据，同时欧易 NFT 市场收录了海量的 NFT 合集数据，能够提供实时准确的链上数据。当前已支持聚合的市场：欧易 NFT，Opensea，Magic Eden，Looksrare，IMX 和 X2Y2。 欧易 NFT 市场支持 NFT 持有者同时在多个市场上架其 NFT 作品并可以最低的交易成本获得最高的流动性，当前已支持上架的市场：欧易 NFT，Opensea，Looksrare 和 Magic Eden。 欧易 NFT 市场已支持的公链： Ethereum、OKTC、BSC、Polygon、Immutable X、Avalanche C、Solana、Arbitrum One、Aptos、zkSync Era、Optimism、Klaytn、Arbitrum Nova、Base和Linea。 未来计划支持在更多链上进行 NFT 聚合交易。 发行市场和二级市场[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%8F%91%E8%A1%8C%E5%B8%82%E5%9C%BA%E5%92%8C%E4%BA%8C%E7%BA%A7%E5%B8%82%E5%9C%BA) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- 发行市场：欧易 NFT 市场是独家的一级发行平台，精选优质 NFT 项目进行完全去中心化发售，用户可在第一时间于发行市场上以较低价格获得心仪的 NFT。 二级市场：欧易 NFT 市场支持用户进行点对点交易，帮助买卖双方寻求最优价格进行成交。我们致力于为用户提供高效、低成本、高流动性的 NFT 交易体验。 合约架构[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%90%88%E7%BA%A6%E6%9E%B6%E6%9E%84) -------------------------------------------------------------------------------------------------------------------- ### 总览[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E6%80%BB%E8%A7%88) #### EVM 合约功能[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#evm-%E5%90%88%E7%BA%A6%E5%8A%9F%E8%83%BD) * 批量购买 * 合集出价 * 一口价挂单 * 商品出价 * 版税立即结算 * ERC-2981 版税支持 #### Solana 合约功能[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#solana-%E5%90%88%E7%BA%A6%E5%8A%9F%E8%83%BD) * 批量购买 * 一口价挂单 * 版税实时结算 ### 欧易NFT二级市场合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E6%AC%A7%E6%98%93nft%E4%BA%8C%E7%BA%A7%E5%B8%82%E5%9C%BA%E5%90%88%E7%BA%A6) 用户授权欧易二级市场对 `union approve` 合约进行授予其使用代币的权限（原生币无须此步骤） 用户调用欧易 `Aggregator` 合约接口与欧易二级市场进行交互，如：出价或挂单 ### 欧易NFT聚合器合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E6%AC%A7%E6%98%93nft%E8%81%9A%E5%90%88%E5%99%A8%E5%90%88%E7%BA%A6) 开发不同市场的 `Adapter` 合约 把 Adapter 合约注册至 `Market Registry` 合约 欧易 `Aggregator` 合约透过 `Adapter` 合约关联不同市场，例如欧易 `Aggregator` 合约透过 `OpenSea Adapter` 合约与 `OpenSea` 市场交互 开始使用[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%BC%80%E5%A7%8B%E4%BD%BF%E7%94%A8) -------------------------------------------------------------------------------------------------------------------- 前往 [NFT 热点](https://web3.okx.com/web3/marketplace/nft) ，玩转您的 NFT 之旅。 你可以前往市场挑选喜欢的 NFT 并出价或直接购买，个人中心可查看你的 NFT 资产，赶快开启你的NFT交易之旅吧。 如果你是充满创意的艺术家创作者，欢迎前往我们的创作页面进行 NFT 创作。 已部署合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%B7%B2%E9%83%A8%E7%BD%B2%E5%90%88%E7%BA%A6) ------------------------------------------------------------------------------------------------------------------------------ ### 聚合器合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E8%81%9A%E5%90%88%E5%99%A8%E5%90%88%E7%BA%A6) | **编号** | **网络** | **合约地址** | | --- | --- | --- | | 1 | Ethereum | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 2 | OKTC | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 3 | BNB Chain | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 4 | Polygon | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 5 | Avalanche-C | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 6 | Arbitrum One | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 7 | Arbitrary Nova | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 8 | zkSync Era | 0x444b2Fd4395Ec890fbC492753DCe1bE2fC8Ff63D | | 9 | Optimism | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 10 | Klaytn | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 11 | Base | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 12 | Linea | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 13 | opBNB | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 14 | Polygon zkEVM | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | ### 欧易自营市场合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E6%AC%A7%E6%98%93%E8%87%AA%E8%90%A5%E5%B8%82%E5%9C%BA%E5%90%88%E7%BA%A6) | **编号** | **网络** | **合约地址** | | --- | --- | --- | | 1 | Ethereum | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 2 | OKTC | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 3 | BNB Chain | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 4 | Polygon | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 5 | Avalanche-C | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 6 | Arbitrum One | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 7 | Arbitrum Nova | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 8 | zkSync Era | 0xd756E8070b33a35E42f00140Ac92c4b4e0bBfb82 | | 9 | Optimism | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 10 | Klaytn | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 11 | Base | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 12 | Linea | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 13 | opBNB | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 14 | Polygon zkEVM | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | [使用 Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) 目录 [NFT 聚合器](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#nft-%E8%81%9A%E5%90%88%E5%99%A8) [发行市场和二级市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%8F%91%E8%A1%8C%E5%B8%82%E5%9C%BA%E5%92%8C%E4%BA%8C%E7%BA%A7%E5%B8%82%E5%9C%BA) [合约架构](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%90%88%E7%BA%A6%E6%9E%B6%E6%9E%84) [开始使用](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%BC%80%E5%A7%8B%E4%BD%BF%E7%94%A8) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction#%E5%B7%B2%E9%83%A8%E7%BD%B2%E5%90%88%E7%BA%A6) --- # 错误码 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API 错误码 错误码[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code#%E9%94%99%E8%AF%AF%E7%A0%81) ================================================================================================= | 代码 | HTTP 状态 | 信息 (英) | 信息 (中) | | --- | --- | --- | --- | | 0 | 200 | Succeeded | 操作成功 | | 50011 | 429 | Rate limit reached. Please refer to API documentation and throttle requests accordingly. | 用户请求频率过快，超过该接口允许的限额。请参考 API 文档并限制请求 | | 50014 | 400 | Parameter {0} cannot be empty. | 必填参数 {0} 不能为空 | | 50026 | 500 | System error. Try again later. | 系统错误，请稍后重试 | | 50103 | 401 | Request header “OK-ACCESS-KEY” cannot be empty. | 请求头“OK\_ACCESS\_KEY”不能为空 | | 50104 | 401 | Request header “OK-ACCESS-PASSPHRASE” cannot be empty. | 请求头“OK\_ACCESS\_PASSPHRASE”不能为空 | | 50105 | 401 | Request header “OK-ACCESS-PASSPHRASE” is incorrect. | 请求头“OK\_ACCESS\_PASSPHRASE”错误 | | 50106 | 401 | Request header “OK-ACCESS-SIGN” cannot be empty. | 请求头“OK\_ACCESS\_SIGN”不能为空 | | 50107 | 401 | Request header “OK-ACCESS-TIMESTAMP” cannot be empty. | 请求头“OK\_ACCESS\_TIMESTAMP”不能为空 | | 50111 | 401 | Invalid OK-ACCESS-KEY | OK\_ACCESS\_KEY 无效 | | 50112 | 401 | Invalid OK-ACCESS-TIMESTAMP | OK\_ACCESS\_TIMESTAMP 无效 | | 50113 | 401 | Invalid signature | 签名无效 | | 84000 | 400 | Parameter error | 参数错误 | | 84001 | 200 | Platform not supported | 不支持的平台 | | 84003 | 200 | Protocol not supported | 不支持的协议 | | 84007 | 200 | Investment product not supported | 不支持的投资品 | | 84010 | 200 | Token not supported | 不支持的币种 | | 84011 | 200 | Platform logo is empty | 平台 logo 为空 | | 84013 | 200 | Swap not supported | 不支持兑换 | | 84014 | 200 | Balance validation unsuccessful | 余额校验失败 | | 84016 | 200 | Smart contract execution unsuccessful | 合约方法执行失败 | | 84017 | 200 | Staking rate validation unsuccessful | 质押率校验失败 | | 84018 | 200 | Balancing unsuccessful | 配平失败 | | 84019 | 200 | Address format unmatched | 地址格式不匹配 | | 84021 | 200 | Syncing assets | 资产同步中 | | 84022 | 200 | Authorization type not supported | 不支持的交易授权 | | 84998 | 200 | Investment error | 投资异常 | | 84999 | 500 | Default error | 默认异常 | [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) --- # 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) [搭建链上数据看板](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) [搭建铭文钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) [搭建 Web3 钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API 快速开始 快速开始[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B) ====================================================================================================================== 根据你的开发目标，查看下方案例，快速上手我们的服务。 [搭建链上数据看板\ \ 通过此案例，可熟悉链上数据查询的各类方式](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) [搭建比特币铭文钱包\ \ 通过此案例，可熟悉钱包管理、铭文数据的查询、铭文交易的构建和广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) [搭建 Web3 钱包\ \ 通过此案例，可熟悉钱包管理、各公链数据的查询、交易构建和广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) --- # 创建移动端 App 内通用链接 | 更多资源 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 更多资源 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 更多资源 创建移动端 App 内通用链接 创建移动端 App 内通用链接[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E5%88%9B%E5%BB%BA%E7%A7%BB%E5%8A%A8%E7%AB%AF-app-%E5%86%85%E9%80%9A%E7%94%A8%E9%93%BE%E6%8E%A5) ==================================================================================================================================================================================== 为了使用户能够在移动端 APP 内轻松交互你的 DApp，你需要在移动浏览器中为你的 DApp 创建 deeplink，实现直接导向 OKX App 的发现页中打开你的 DApp。 本教程将使用 JavaScript 引导你完成这个过程。 ### 步骤 1：定义深度链接参数[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E6%B7%B1%E5%BA%A6%E9%93%BE%E6%8E%A5%E5%8F%82%E6%95%B0) 打开你的 JavaScript 文件或脚本，定义你想作为深度链接参数传递的 URL： const dappUrl = "https://app.uniswap.org/"; 将 `https://app.uniswap.org/` 替换为你 DApp 的实际 URL。 ### 步骤 2：编码 deeplink 参数[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E7%BC%96%E7%A0%81-deeplink-%E5%8F%82%E6%95%B0) 使用 `encodeURIComponent` 对 `dappUrl` 进行编码： const encodedDappUrl = encodeURIComponent(dappUrl); 这确保了 URL 中的特殊字符会被正确处理，以便包含在网页链接中。 ### 步骤 3：构建 deeplink[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E6%9E%84%E5%BB%BA-deeplink) 将编码的参数组合起来形成深度链接： const deepLink = "okx://wallet/dapp/url?dappUrl=" + encodedDappUrl; 这创建了特定于你 DApp 的深度链接，适用于 OKX 平台。 ### 步骤 4：编码整个URL[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E6%AD%A5%E9%AA%A4-4%EF%BC%9A%E7%BC%96%E7%A0%81%E6%95%B4%E4%B8%AAurl) 编码整个 URL，包括深度链接，以确保在 Web 应用程序中有正确的格式： const encodedUrl = "https://web3.okx.com/download?deeplink=" + encodeURIComponent(deepLink); 这产生了用户将要与之交互的最终可供跳转的 deeplink。 ### 步骤 5：输出或使用[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E6%AD%A5%E9%AA%A4-5%EF%BC%9A%E8%BE%93%E5%87%BA%E6%88%96%E4%BD%BF%E7%94%A8) 你可以将 `encodedUrl` 打印到控制台或根据需要在你的应用程序中使用： console.log(encodedUrl); 这一行是为了演示目的；在你的实际应用程序中，你将根据需要使用 `encodedUrl`。 ### 测试：[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E6%B5%8B%E8%AF%95%EF%BC%9A) 这段 JavaScript 代码是一个客户端脚本，用于检查用户的设备和环境，以确定用户是否从移动设备(特别是 iOS 或 Android 设备)访问网页，并且是否正在使用 OKX 应用。 const ua = navigator.userAgent; const isIOS = /iphone|ipad|ipod|ios/i.test(ua); const isAndroid = /android|XiaoMi|MiuiBrowser/i.test(ua); const isMobile = isIOS || isAndroid; const isOKApp = /OKApp/i.test(ua); if (isMobile && !isOKApp){ const encodedUrl = "https://web3.okx.com/download?deeplink=" + encodeURIComponent("okx://wallet/dapp/url?dappUrl=" + encodeURIComponent(location.href)); window.location.href = encodedUrl; } else if (window.okxwallet) { const accounts = await window.okxwallet.request({ method: "eth_requestAccounts", }); } ### 总结：[#](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link#%E6%80%BB%E7%BB%93%EF%BC%9A) 通过遵循这些步骤，你已成功为你的 DApp 在发现页应用中创建了 deeplink 深度链接。这个链接在使用时会无缝地将用户引导到你的 DApp，从而为您的 DApp 开辟 OKX Web3 的百万流量通道。 [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) --- # 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API 交易广播 交易广播[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api#%E4%BA%A4%E6%98%93%E5%B9%BF%E6%92%AD) =============================================================================================================================== 交易广播 API 接口，提供获取签名数据、广播交易，以及跟踪发送后的交易等服务。 [获取交易信息\ \ 获取签名数据、gas 网络手续费、nonce 等信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [交易广播\ \ 广播及设置交易广播相关的策略](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查询广播的交易\ \ 查询广播后的交易订单状态](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) --- # 搭建限价单应用 | 快速开始 | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [搭建兑换应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-quick-start-reference) [搭建跨链应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-api-quick-start-reference) [搭建限价单应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) 搭建限价单应用 搭建限价单应用[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#%E6%90%AD%E5%BB%BA%E9%99%90%E4%BB%B7%E5%8D%95%E5%BA%94%E7%94%A8) ===================================================================================================================================================== 在本指南中，我们将通过欧易 DEX 提供一个用例来进行限价单下单。这个过程包括: * 设置你的环境 * 检查授权额度 * 创建订单 * 取消订单 1\. 设置你的环境[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) -------------------------------------------------------------------------------------------------------------------------------------------------- 导入必要的 Node.js 库并设置你的环境变量以及定义辅助函数和组装参数 [Node.js 环境设置](https://web3.okx.com/cn/web3/build/docs/waas/nodejs-environment) 2\. 检查授权额度[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#2.-%E6%A3%80%E6%9F%A5%E6%8E%88%E6%9D%83%E9%A2%9D%E5%BA%A6) -------------------------------------------------------------------------------------------------------------------------------------------------- ### 2.1 请参考查询授权额度教程[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#2.1-%E8%AF%B7%E5%8F%82%E8%80%83%E6%9F%A5%E8%AF%A2%E6%8E%88%E6%9D%83%E9%A2%9D%E5%BA%A6%E6%95%99%E7%A8%8B) [查询授权额度](https://web3.okx.com/cn/web3/build/docs/waas/dex-limit-order-get-allowance) * 下文的 allowanceAmount 代表真实的链上授权额度 ### 2.2 获取授权数量[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#2.2-%E8%8E%B7%E5%8F%96%E6%8E%88%E6%9D%83%E6%95%B0%E9%87%8F) 获取数量。如果 `allowanceAmount !== '0'`，请查看步骤 4。如果 `allowanceAmount === '0'`，请查看步骤 5。 const { data: allowanceData } = await getAllowanceData(); const allowanceAmount = allowanceData?.[0]?.allowanceAmount; 3\. 创建订单[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#3.-%E5%88%9B%E5%BB%BA%E8%AE%A2%E5%8D%95) ------------------------------------------------------------------------------------------------------------------------------ 提示 如果 allowanceAmount 大于零，则表示已执行批准操作，可以直接创建订单。 ### 3.1 离线签名[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#3.1-%E7%A6%BB%E7%BA%BF%E7%AD%BE%E5%90%8D) 采用 EIP712 结构化签名，签名时钱包将显示订单结构化内容。 const ethers = require('ethers'); // Build domain data const domainData = { name: 'OKX LIMIT ORDER', version: '2.0', chainId: 1, // The chainId of the ETH mainnet verifyingContract: '0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2' // LimitOrder contract address }; // Define the limit order type const Order = [\ { name: "salt", type: "uint256" },\ { name: "makerToken", type: "address" },\ { name: "takerToken", type: "address" },\ { name: "maker", type: "address" },\ { name: "receiver", type: "address" },\ { name: "allowedSender", type: "address" },\ { name: "makingAmount", type: "uint256" },\ { name: "takingAmount", type: "uint256" },\ { name: "minReturn", type: "uint256" },\ { name: "deadLine", type: "uint256" },\ { name: "partiallyAble", type: "bool" }\ ]; const orderData = { salt: 1702979522, makerToken: "0xdAC17F958D2ee523a2206206994597C13D831ec7", takerToken: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", maker: "0x5F73e69237eB5bA3544273D165907447bF6a0AA7", receiver: "0x5F73e69237eB5bA3544273D165907447bF6a0AA7", allowedSender: "0x0000000000000000000000000000000000000000", makingAmount: 1000000, takingAmount: 1000000, minReturn: 1000000, deadLine: 1703254942, partiallyAble: true } // Build EIP-712 messages const message = { domain: domainData, types: { Order }, value: orderData, }; // Create an Ethereum signature wallet const privateKey = ''; const wallet = new ethers.Wallet(privateKey); (async () => { // Calculate the EIP-712 orderHash const orderHash = ethers.utils._TypedDataEncoder.hash(message.domain, message.types, message.value); console.log("Order data:", orderData); console.log("Order Hash:", orderHash); // Sign the message with the privatekey const signature = await wallet._signTypedData( message.domain, message.types, message.value ); console.log("Order signature:", signature); })(); ### 3.2 定义参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#3.2-%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) const limitOrderRequestParams = { orderHash,orderData,chainId, signature }; ### 3.3 下单[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#3.3-%E4%B8%8B%E5%8D%95) const resp = await fetch(apiBaseUrl +"/limit-order/save-order", { method: "POST", body: JSON.stringify(limitOrderRequestParams), headers: headersParams, }); 4\. 取消订单[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#4.-%E5%8F%96%E6%B6%88%E8%AE%A2%E5%8D%95) ------------------------------------------------------------------------------------------------------------------------------ const ethers = require('ethers'); // 示例限价单数据 const orderData = { salt: 1700110500, //随机数盐，作为幂等标识，(传入当前时间戳) makerToken: "0xMakerTokenAddress", //兑入币种地址 takerToken: "0xTakerTokenAddress", //兑出币种地址 maker: "0xMakerAddress", //用户钱包地址 receiver: "0xTakerAddress", //用户指定收款地址 allowedSender: "0xAllowedSender", //用户指定交易对方地址 makingAmount: 2000, //兑入币种数量 takingAmount: 1000, //兑出币种数量 minReturn: 950, //最少兑出币种数量，用于滑点控制 deadLine: 1700120500, //订单超时时间戳 partiallyAble: false //是否支持部分成交 }; // 连接到以太坊节点 const provider = new ethers.providers.JsonRpcProvider("https://mainnet.infura.io/v3/your_infura_project_id"); // 合约地址和 ABI const contractAddress = "0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2"; // LimitOrder合约地址 const contractABI = [\ {\ "inputs": [\ {\ "components": [\ {\ "internalType": "uint256",\ "name": "salt",\ "type": "uint256"\ },\ {\ "internalType": "address",\ "name": "makerToken",\ "type": "address"\ },\ {\ "internalType": "address",\ "name": "takerToken",\ "type": "address"\ },\ {\ "internalType": "address",\ "name": "maker",\ "type": "address"\ },\ {\ "internalType": "address",\ "name": "receiver",\ "type": "address"\ },\ {\ "internalType": "address",\ "name": "allowedSender",\ "type": "address"\ },\ {\ "internalType": "uint256",\ "name": "makingAmount",\ "type": "uint256"\ },\ {\ "internalType": "uint256",\ "name": "takingAmount",\ "type": "uint256"\ },\ {\ "internalType": "uint256",\ "name": "minReturn",\ "type": "uint256"\ },\ {\ "internalType": "uint256",\ "name": "deadLine",\ "type": "uint256"\ },\ {\ "internalType": "bool",\ "name": "partiallyAble",\ "type": "bool"\ }\ ],\ "internalType": "struct OrderLibV2.Order",\ "name": "_order",\ "type": "tuple"\ }\ ],\ "name": "cancelOrder",\ "outputs": [\ {\ "internalType": "uint256",\ "name": "orderRemaining",\ "type": "uint256"\ },\ {\ "internalType": "bytes32",\ "name": "orderHash",\ "type": "bytes32"\ }\ ],\ "stateMutability": "nonpayable",\ "type": "function"\ }\ ]; // 使用合约 ABI 和地址创建合约实例 const contract = new ethers.Contract(contractAddress, contractABI, provider); // 使用私钥创建钱包 const privateKey = "your_private_key"; const wallet = new ethers.Wallet(privateKey, provider); // 撤销订单 async function cancelOrder(orderData) { const tx = await contract.connect(wallet).cancelOrder(orderData); await tx.wait; console.log("txhash:", tx.hash); } // 交互示例 (async () => { await cancelOrder(orderData); })(); [在 Solana 链上发送多签交易](https://web3.okx.com/zh-hans/build/docs/waas/dex-use-crosschain-solana-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) 目录 [1\. 设置你的环境](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) [2\. 检查授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#2.-%E6%A3%80%E6%9F%A5%E6%8E%88%E6%9D%83%E9%A2%9D%E5%BA%A6) [3\. 创建订单](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#3.-%E5%88%9B%E5%BB%BA%E8%AE%A2%E5%8D%95) [4\. 取消订单](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start#4.-%E5%8F%96%E6%B6%88%E8%AE%A2%E5%8D%95) --- # 资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) [常用参数定义](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) [查看 chainIndex](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-errorcode) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API 资源 资源[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources#%E8%B5%84%E6%BA%90) =========================================================================================== [常用参数定义\ \ 钱包 API 服务时涉及到的定义介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) [查询 chainIndex\ \ 已支持的区块链网络](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) [Webhook用法\ \ 使用 Webhook 服务订阅链上数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-bp-data-subscription) [Go 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk) [常用参数定义](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) --- # 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) [申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) [赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) [领取奖励流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API 快速开始 快速开始[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B) =========================================================================================================== [概述\ \ 本页面说明了欧易 Web3 DeFi 投资过程的数据交互流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) [申购流程\ \ 本页面说明了申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) [赎回流程\ \ 本页面说明了赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) [领取奖励流程\ \ 本页面说明了领取奖励金流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) --- # Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [获取 Fractal Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API Fractal Ordinals API Fractal Ordinals 市场 API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api#fractal-ordinals-%E5%B8%82%E5%9C%BA-api) ================================================================================================================================================== [获取 Fractal Ordinals 合集列表\ \ 获取Fractal Ordinals合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) [获取 Fractal Ordinals 交易历史\ \ 获取Fractal Ordinals交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) [获取铭文资产列表\ \ 获取钱包资产信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [获取 Fractal Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) --- # 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API 链上信息查询 链上信息查询[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api#%E9%93%BE%E4%B8%8A%E4%BF%A1%E6%81%AF%E6%9F%A5%E8%AF%A2) ============================================================================================================================================= 链上信息查询提供 Web3 开发相关的核心数据 API 接口，包含链数据、资产数据、币价及项目信息数据、交易历史数据以及授权数据等。 [查询支持的区块链\ \ 提供钱包 API 支持的区块链网络相关信息](https://web3.okx.com/zh-hans/build/docs/waas/api-get-supported-blockchain) [币价和项目信息\ \ 查询历史币价、实时币价及币种项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产\ \ 查询地址维度资产详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产\ \ 查询账户维度资产详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史\ \ 查询任意地址的交易摘要及详细交易内容，包含铭文交易详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [搭建 Web3 钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) --- # 跨链 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-api) [支持的跨链桥](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-supported-bridges) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-faq) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API 跨链 API 跨链 API[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator#%E8%B7%A8%E9%93%BE-api) ========================================================================================================= [API 参考\ \ 跨链 API 的参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-api) [智能合约\ \ 跨链 API 的智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-smart-contract) [错误码\ \ 跨链 API 的错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-error-code) [FAQ\ \ 跨链 API 的常见问题解答](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-faq) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-faq) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-api) --- # 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API 限价单 API 限价单 API[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order#%E9%99%90%E4%BB%B7%E5%8D%95-api) ========================================================================================================= [API 参考\ \ 限价单 API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [智能合约\ \ 限价单 API 的智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码\ \ 限价单 API 的错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ\ \ 限价单 API 的常见问题](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-faq) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) --- # 快速开始 | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [搭建兑换应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-quick-start-reference) [搭建跨链应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-api-quick-start-reference) [搭建限价单应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API 快速开始 快速开始[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B) ============================================================================================================================ 在开始使用DEX API 之前，你需要先在开发者管理平台[创建项目](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E5%88%9B%E5%BB%BA%E9%A1%B9%E7%9B%AE) 并[生成 API key](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E7%94%9F%E6%88%90-api-key) 。以下是详细的步骤和相关资源： [在 EVM 链上搭建兑换应用\ \ 兑换 API 快速上手指南](https://web3.okx.com/zh-hans/build/docs/waas/dex-use-swap-quick-start) [在 Solana 链上搭建兑换应用\ \ 在 Solana 链上搭建应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-use-swap-solana-quick-start) [搭建跨链应用\ \ 跨链 API 快速上手指南](https://web3.okx.com/zh-hans/build/docs/waas/dex-use-crosschain-quick-start) [搭建限价单应用\ \ 限价单 API 快速上手指南](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-quick-start) [限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-process) [搭建兑换应用](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-quick-start-reference) --- # API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API API 参考 API 参考[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference#api-%E5%8F%82%E8%80%83) ================================================================================================== [介绍\ \ 用于介绍 DeFi API 的业务场景的信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息\ \ 用于获取协议、平台、投资品的信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算\ \ 用于计算投资收益和回报的工具](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易\ \ 用于上链交易的调用数据信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户\ \ 用于查询用户资产和持仓信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [领取奖励流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) --- # 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API 钱包账户管理 钱包账户管理[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api#%E9%92%B1%E5%8C%85%E8%B4%A6%E6%88%B7%E7%AE%A1%E7%90%86) =============================================================================================================================================== 钱包账户管理 API 接口，提供对钱包账户地址进行增、删、改和查相关的服务。 [创建账户\ \ 创建一个聚合多链地址的钱包账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-watch-only-account) [更新账户\ \ 更新该钱包账户下的多链地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-watch-only-account) [删除账户\ \ 删除一个钱包账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询已创建\ \ 查询已创建的钱包账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [查询账户下的地址\ \ 查询特定钱包账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) --- # Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API Runes API Runes 市场 API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api#runes-%E5%B8%82%E5%9C%BA-api) ================================================================================================================= [获取合集信息\ \ 获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集\ \ 获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史\ \ 获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产\ \ 获取钱包资产信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息\ \ 获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单\ \ 创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) --- # Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API Ordinals API BTC Ordinals 市场 API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api#btc-ordinals-%E5%B8%82%E5%9C%BA-api) ================================================================================================================================== [快速开始\ \ 快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单\ \ 创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取 Ordinals 合集列表\ \ 获取全部 BTC NFT 和 BRC20 合集的列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单\ \ 获取指定合集下所有有效订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史\ \ 获取某个合集下所有成交的记录](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型\ \ 获取 Ordinals 相关模型的信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) --- # API 参考 | 兑换 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-aggregator-supported-chains) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-tokens) [获取流动性列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-liquidity) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-approve-transaction) [获取兑换价格](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-quote) [获取 Solana 兑换交易指令](https://web3.okx.com/zh-hans/build/docs/waas/dex-solana-swap-instruction) [兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-swap) [查询交易状态](https://web3.okx.com/zh-hans/build/docs/waas/dex-swap-history) [设置分佣](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-addfee) [Dex 集成](https://web3.okx.com/zh-hans/build/docs/waas/dex-integration) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-faq) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) API 参考 API 参考[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-api-reference#api-%E5%8F%82%E8%80%83) ================================================================================================= [获取支持的链\ \ 获取欧易 DEX 聚合器协议单链支持兑换的链列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-aggregator-supported-chains) [获取币种列表\ \ 获取欧易 DEX 聚合器协议支持兑换的币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-tokens) [获取流动性列表\ \ 获取欧易 DEX 聚合器协议支持兑换的流动性池列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-liquidity) [交易授权\ \ 提供发起授权交易前所需要的交易信息](https://web3.okx.com/zh-hans/build/docs/waas/dex-approve-transaction) [获取兑换价格\ \ 通过欧易 DEX 聚合器获取最优报价](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-quote) [获取 Solana 兑换交易指令\ \ 通过欧易 DEX 聚合器获取 Solana 兑换指令](https://web3.okx.com/zh-hans/build/docs/waas/dex-solana-swap-instruction) [兑换\ \ 通过欧易 DEX 聚合器路由获取兑换所需的交易数据](https://web3.okx.com/zh-hans/build/docs/waas/dex-swap) [查询交易状态\ \ 通过欧易 DEX 聚合器获取兑换交易历史记录](https://web3.okx.com/zh-hans/build/docs/waas/dex-swap-history) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-aggregator-supported-chains) --- # API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API API 参考 NFT 市场 API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference#nft-%E5%B8%82%E5%9C%BA-api) ================================================================================================================= [NFT API\ \ 查看 NFT API 的具体调用方式](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API\ \ 查看资产 API 的具体调用方式](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API\ \ 查看合集 API 的具体调用方式](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API\ \ 查看订单 API 的具体调用方式](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [模型\ \ 获取模型的相关信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互\ \ 明确不同订单类型的具体参数](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约\ \ 已部署合约地址的总结](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) --- # 概述 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) [申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) [赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) [领取奖励流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) 概述 概述[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview#%E6%A6%82%E8%BF%B0) ================================================================================================ 本页面说明了欧易 Web3 DeFi 投资过程的数据交互流程。 交互流程[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview#%E4%BA%A4%E4%BA%92%E6%B5%81%E7%A8%8B) -------------------------------------------------------------------------------------------------------------------- 1. 申购流程。 2. 赎回流程。 3. 领取奖励金流程。 [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) 目录 [交互流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview#%E4%BA%A4%E4%BA%92%E6%B5%81%E7%A8%8B) --- # 使用开发者管理平台 | 接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [使用开发者管理平台](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) [REST API 鉴权](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 介绍 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 介绍 [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) 使用开发者管理平台 使用开发者管理平台[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E4%BD%BF%E7%94%A8%E5%BC%80%E5%8F%91%E8%80%85%E7%AE%A1%E7%90%86%E5%B9%B3%E5%8F%B0) ======================================================================================================================================================================================== 为了帮助你更高效地构建自己的应用，本篇将介绍开发者管理平台的功能以及最佳使用方法。 创建项目[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E5%88%9B%E5%BB%BA%E9%A1%B9%E7%9B%AE) -------------------------------------------------------------------------------------------------------------------------------------- ### 使用开发者管理平台开始操作[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E4%BD%BF%E7%94%A8%E5%BC%80%E5%8F%91%E8%80%85%E7%AE%A1%E7%90%86%E5%B9%B3%E5%8F%B0%E5%BC%80%E5%A7%8B%E6%93%8D%E4%BD%9C) ### 步骤 1：创建/登录你的账户[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%88%9B%E5%BB%BA/%E7%99%BB%E5%BD%95%E4%BD%A0%E7%9A%84%E8%B4%A6%E6%88%B7) 1. 点击导航栏**开发者中心**下的[开发者管理平台](https://web3.okx.com/cn/web3/build/dev-portal) 。 2. 点击**连接钱包**创建或登录账户。 3. 选择希望连接的钱包，推荐使用欧易 Web3 钱包进行连接。 4. 选择好钱包后，点击**验证**，钱包处将弹出一个窗口。在钱包内点击**签名**。 恭喜！你已成功创建账户，并登录至开发者管理平台。 ### 步骤 2：创建一个新的项目[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%88%9B%E5%BB%BA%E4%B8%80%E4%B8%AA%E6%96%B0%E7%9A%84%E9%A1%B9%E7%9B%AE) 1. 欲创建新项目，仅需要输入项目名称和项目描述 (可选) ，然后点击**确认**按钮创建新项目。 2. 创建新项目后，你可以在**项目**选项下看到项目的详细信息。 3. 如果打算新建其他项目，请点击**创建新项目**。 生成 API key[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E7%94%9F%E6%88%90-api-key) ---------------------------------------------------------------------------------------------------------------------------------- 成功注册后，接下来可以生成和使用 API key。 ### 预备知识[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E9%A2%84%E5%A4%87%E7%9F%A5%E8%AF%86) **API key**：为应用程序或用户提供一个唯一标识，使其能够与 API 进行交互。 **Secret key**：与 API key 配合使用，通过增加一道安全令牌来提供额外的安全保证。 **Passphrase**： 用于在 OKX OS 服务端加密 Secret key，提供额外的安全防范。另外查看 Secret key、修改 API 信息也会用到 Passphrase。 ### 生成新的 API key[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E7%94%9F%E6%88%90%E6%96%B0%E7%9A%84-api-key) 1. 在需要创建 API key 的项目处点击**管理**按钮。 2. 点击**创建 API key** 按钮。 3. 输入 **API key** 的名称和 **Passphrase**，点击**创建**生成相应的 API key。 **Passphrase** 是使用 API 的必要条件。一旦 Passphrase 丢失，将无法再使用 API key。请牢记密码短语。 恭喜！你已成功创建了 API key。 ### 查看 Secret key[#](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E6%9F%A5%E7%9C%8B-secret-key) 在向 API 发起请求时，需要也需要提供 Secret key。点击右侧的**复制**按钮，可查看你的 Secret key。 [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [REST API 鉴权](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) 目录 [创建项目](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E5%88%9B%E5%BB%BA%E9%A1%B9%E7%9B%AE) [生成 API key](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#%E7%94%9F%E6%88%90-api-key) --- # 准备工作 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) [搭建链上数据看板](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) [搭建铭文钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) [搭建 Web3 钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) 准备工作 准备工作[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation#%E5%87%86%E5%A4%87%E5%B7%A5%E4%BD%9C) ============================================================================================================================ 创建项目及 API Key[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation#%E5%88%9B%E5%BB%BA%E9%A1%B9%E7%9B%AE%E5%8F%8A-api-key) ------------------------------------------------------------------------------------------------------------------------------------------------------ 在开始使用钱包 API 之前，你需要先在开发者管理平台创建项目并生成 API key。以下是详细的步骤和相关资源： 1. 登录开发者管理平台。 2. 创建新的项目。 3. 在项目设置中生成 API key。 我们已经为你准备了详细的指南，帮助你完成这些步骤。你可以阅读[开发者管理平台指南](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) ，以便更快地开始使用。 其次，你还需要做一些基础的调用配置工作。 REST 请求验证配置[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation#rest-%E8%AF%B7%E6%B1%82%E9%AA%8C%E8%AF%81%E9%85%8D%E7%BD%AE) ---------------------------------------------------------------------------------------------------------------------------------------------------------- 在发送 REST 请求时，你需要进行验证。我们提供了一个详细的 [REST 请求验证指南](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) ，帮助你理解和实施这个过程。 Node.js 环境设置[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation#node.js-%E7%8E%AF%E5%A2%83%E8%AE%BE%E7%BD%AE) -------------------------------------------------------------------------------------------------------------------------------------------- 导入必要的 Node.js 库并设置你的环境变量以及定义辅助函数和组装参数 [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) 。 [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [搭建链上数据看板](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) 目录 [创建项目及 API Key](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation#%E5%88%9B%E5%BB%BA%E9%A1%B9%E7%9B%AE%E5%8F%8A-api-key) [REST 请求验证配置](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation#rest-%E8%AF%B7%E6%B1%82%E9%AA%8C%E8%AF%81%E9%85%8D%E7%BD%AE) [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation#node.js-%E7%8E%AF%E5%A2%83%E8%AE%BE%E7%BD%AE) --- # 查询支持的区块链 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) 查询支持的区块链 查询支持的区块链[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain#%E6%9F%A5%E8%AF%A2%E6%94%AF%E6%8C%81%E7%9A%84%E5%8C%BA%E5%9D%97%E9%93%BE) ========================================================================================================================================================================== 除了[这部分](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) 的API，查询钱包 API 当前支持的所有区块链网络的信息，如 Bitcoin，Ethereum 网络上的 logo 和主链币唯一标识等。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/chain/supported-chains` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) 无 ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | name | String | 链名称 | | logoUrl | String | 链标志 URL | | shortName | String | 链简称 | | chainIndex | String | 链唯一标识 | [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/chain/supported-chains' --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "name": "Ethereum",\ "logoUrl": "http://www.eth.org/eth.png",\ "shortName": "ETH",\ "chainIndex": "1"\ }\ ], "msg": "" } [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) --- # 创建账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) 创建账户 创建账户[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account#%E5%88%9B%E5%BB%BA%E8%B4%A6%E6%88%B7) =============================================================================================================================== 绑定多个地址，创建钱包账户，支持的链默认返回全量币种，同时可实现对资产和交易历史等信息的聚合查询。 注意 钱包账户支持的聚合的地址数量有上限，以我们[支持的链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) 所对应的数量为准。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/account/create-wallet-account` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | addresses | Array | Yes | 地址列表。（单次调用最多50个地址，后续添加可使用[更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-watch-only-account)
） | | \>chainIndex | String | Yes | 链唯一标识 | | \>address | String | Yes | 地址 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | accountId | String | 账户的唯一标识 | [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/account/create-wallet-account' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "addresses": [\ {\ "chainIndex":"1",\ "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db",\ },{\ "chainIndex":"0",\ "address":"bc1p939endmmt6pvz7ukeywpfsazz57cc4vdu3d0qerz6crhgrtmerfssls5wy",\ }\ ] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "accountId": "13886e05-1265-4b79-8ac3-b7ab46217655"\ }\ ], "msg": "success" } [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) --- # REST API 鉴权 | 接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [使用开发者管理平台](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) [REST API 鉴权](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 介绍 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 介绍 [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) REST API 鉴权 REST API 鉴权[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#rest-api-%E9%89%B4%E6%9D%83) ============================================================================================================= 发起请求[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E5%8F%91%E8%B5%B7%E8%AF%B7%E6%B1%82) --------------------------------------------------------------------------------------------------------------- 所有 REST 私有请求头都必须包含以下内容： * `OK-ACCESS-KEY` 字符串类型的 API key (遵循[这个指南](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface#generate-api-keys) 来生成一个 API key) * `OK-ACCESS-SIGN` 使用 HMAC SHA256 哈希函数获得哈希值，再使用 Base-64 编码 (请参阅签名) * `OK-ACCESS-TIMESTAMP` 发起请求的时间 (UTC) ，如：2020-12-08T09:08:57.715Z * `OK-ACCESS-PASSPHRASE` 你在创建 API key 时指定的 Passphrase 一些端点，例如 WaaS，需要额外的请求头： * `OK-ACCESS-PROJECT` 你的项目的项目 ID (可在项目详细信息下找到) 所有请求都应该含有`application/json`类型内容，并且是有效的 JSON。 签名[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E7%AD%BE%E5%90%8D) ------------------------------------------------------------------------------------------- `OK-ACCESS-SIGN`的请求头： * 是对`timestamp + method + requestPath + body`字符串 (+ 表示字符串连接)，以及 Secret key，使用 HMAC SHA256 方法加密，通过 Base-64 编码输出而得到的。 * 准备 Secret key (在创建 API key 时生成)。 * 使用 HMAC SHA256 使用密钥对预哈希字符串进行签名。 * 以 Base64 格式对签名进行编码。 例子： `sign=CryptoJS.enc.Base64.stringify(CryptoJS.HmacSHA256(timestamp + 'GET' + '/api/v5/account/balance?ccy=BTC', SecretKey))` * 其中，`timestamp`的值与`OK-ACCESS-TIMESTAMP`请求头相同，为 ISO 格式 * 如：`2020-12-08T09:08:57.715Z` * method 是请求方法，字母全部大写 * 如：`GET/POST` * requestPath 是请求接口路径 * 如：`/api/v5/account/balance` * body 是指请求主体的字符串，如果请求没有主体（通常为 GET 请求）则 body 可省略 * 如：`{"instId":"BTC-USDT","lever":"5","mgnMode":"isolated"}` * `GET`请求参数是算作 requestPath，不算 body Postman 示例[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#postman-%E7%A4%BA%E4%BE%8B) ----------------------------------------------------------------------------------------------------------- Postman 是一款流行的 API 开发和测试工具，允许开发人员设计、测试和记录 API。它提供了对用户友好的图形界面，用于向 API 发送 HTTP 请求。 如果你还没有安装 Postman，你可以免费从 Postman 网站下载它：[https://www.postman.com/](https://www.postman.com/) 提示 这个示例需要你具备对 Postman 的基础理解。 ### 添加参数[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E6%B7%BB%E5%8A%A0%E5%8F%82%E6%95%B0) * 这通常适用于 GET 请求。 * 如果你的请求需要查询参数，你可以在 **Params** 选项卡下添加它们。在这里，你可以添加查询参数的 key-value pair。 ### 设置标题[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E8%AE%BE%E7%BD%AE%E6%A0%87%E9%A2%98) 在 **Headers** 选项卡下，添加以下键-值对： * `OK-ACCESS-KEY` * `OK-ACCESS-PASSPHRASE` * `OK-ACCESS-PROJECT`(如果需要) ### 添加正文[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E6%B7%BB%E5%8A%A0%E6%AD%A3%E6%96%87) * 这通常适用于 POST 请求。 * 如果你的请求需要一个请求主体，你可以在 **Body** 选项卡下添加它们。 * 在下拉菜单中选择 **raw** 和 **JSON**。 * 使用 JSON 格式输入你的请求主体。 ### 设置预请求脚本[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E8%AE%BE%E7%BD%AE%E9%A2%84%E8%AF%B7%E6%B1%82%E8%84%9A%E6%9C%AC) * 用于生成所需的签名 (`OK-ACCESS-SIGN`) 和时间戳 (`OK-ACCESS-TIMESTAMP`)。 * 在 **Pre-request Script** 选项卡下，插入与请求类型相对应的脚本。 * 在生成预哈希字符串时，GET 请求会排除请求主体。 * 根据需要编辑密钥。 GET 请求： var method = pm.request.method; var now = new Date(); var isoString = now.toISOString(); var path = pm.request.url.getPathWithQuery(); var sign=CryptoJS.enc.Base64.stringify(CryptoJS.HmacSHA256(isoString + method + path, pm.variables.replaceIn('{{secret_key}}'))); pm.request.headers.add({ key: 'OK-ACCESS-SIGN', value: sign }); pm.request.headers.add({ key: 'OK-ACCESS-TIMESTAMP', value: isoString }); POST 请求: var method = pm.request.method; var now = new Date(); var isoString = now.toISOString(); var path = pm.request.url.getPathWithQuery(); var bodyStr = pm.request.body.raw; var sign=CryptoJS.enc.Base64.stringify(CryptoJS.HmacSHA256(isoString + method + path + bodyStr, pm.variables.replaceIn('{{secret_key}}'))) pm.request.headers.add({ key: 'OK-ACCESS-SIGN', value: sign }); pm.request.headers.add({ key: 'OK-ACCESS-TIMESTAMP', value: isoString }); Javascript 示例[#](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#javascript-%E7%A4%BA%E4%BE%8B) ----------------------------------------------------------------------------------------------------------------- 若要通过 Javascript 脚本调用 API，请参考以下代码示例： const https = require('https'); const crypto = require('crypto'); const querystring = require('querystring'); // 定义 API 凭证和项目 ID const api_config = { "api_key": '', "secret_key": '', "passphrase": '', "project": '' // 此处仅适用于 WaaS APIs }; function preHash(timestamp, method, request_path, params) { // 根据字符串和参数创建预签名 let query_string = ''; if (method === 'GET' && params) { query_string = '?' + querystring.stringify(params); } if (method === 'POST' && params) { query_string = JSON.stringify(params); } return timestamp + method + request_path + query_string; } function sign(message, secret_key) { // 使用 HMAC-SHA256 对预签名字符串进行签名 const hmac = crypto.createHmac('sha256', secret_key); hmac.update(message); return hmac.digest('base64'); } function createSignature(method, request_path, params) { // 获取 ISO 8601 格式时间戳 const timestamp = new Date().toISOString().slice(0, -5) + 'Z'; // 生成签名 const message = preHash(timestamp, method, request_path, params); const signature = sign(message, api_config['secret_key']); return { signature, timestamp }; } function sendGetRequest(request_path, params) { // 生成签名 const { signature, timestamp } = createSignature("GET", request_path, params); // 生成请求头 const headers = { 'OK-ACCESS-KEY': api_config['api_key'], 'OK-ACCESS-SIGN': signature, 'OK-ACCESS-TIMESTAMP': timestamp, 'OK-ACCESS-PASSPHRASE': api_config['passphrase'], 'OK-ACCESS-PROJECT': api_config['project'] // 这仅适用于 WaaS APIs }; const options = { hostname: 'web3.okx.com', path: request_path + (params ? `?${querystring.stringify(params)}` : ''), method: 'GET', headers: headers }; const req = https.request(options, (res) => { let data = ''; res.on('data', (chunk) => { data += chunk; }); res.on('end', () => { console.log(data); }); }); req.end(); } function sendPostRequest(request_path, params) { // 生成签名 const { signature, timestamp } = createSignature("POST", request_path, params); // 生成请求头 const headers = { 'OK-ACCESS-KEY': api_config['api_key'], 'OK-ACCESS-SIGN': signature, 'OK-ACCESS-TIMESTAMP': timestamp, 'OK-ACCESS-PASSPHRASE': api_config['passphrase'], 'OK-ACCESS-PROJECT': api_config['project'], // 这仅适用于 WaaS APIs 'Content-Type': 'application/json' // POST 请求需要加上这个头部 }; const options = { hostname: 'web3.okx.com', path: request_path, method: 'POST', headers: headers }; const req = https.request(options, (res) => { let data = ''; res.on('data', (chunk) => { data += chunk; }); res.on('end', () => { console.log(data); }); }); if (params) { req.write(JSON.stringify(params)); } req.end(); } // GET 请求示例 const getRequestPath = '/api/v5/dex/aggregator/quote'; const getParams = { 'chainId': 42161, 'amount': 1000000000000, 'toTokenAddress': '0xff970a61a04b1ca14834a43f5de4533ebddb5cc8', 'fromTokenAddress': '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1' }; sendGetRequest(getRequestPath, getParams); // POST 请求示例 const postRequestPath = '/api/v5/mktplace/nft/ordinals/listings'; const postParams = { 'slug': 'sats' }; sendPostRequest(postRequestPath, postParams); [使用开发者管理平台](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) 目录 [发起请求](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E5%8F%91%E8%B5%B7%E8%AF%B7%E6%B1%82) [签名](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#%E7%AD%BE%E5%90%8D) [Postman 示例](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#postman-%E7%A4%BA%E4%BE%8B) [Javascript 示例](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication#javascript-%E7%A4%BA%E4%BE%8B) --- # Node.js 环境设置 | 接入前提 | 介绍 | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [使用开发者管理平台](https://web3.okx.com/zh-hans/build/docs/waas/introduction-to-developer-portal-interface) [REST API 鉴权](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) [Node.js 环境设置](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 介绍 [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 介绍 [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) Node.js 环境设置 Node.js 环境设置[#](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#node.js-%E7%8E%AF%E5%A2%83%E8%AE%BE%E7%BD%AE) ============================================================================================================================== 1\. 导入必要的 Node.js 库[#](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#1.-%E5%AF%BC%E5%85%A5%E5%BF%85%E8%A6%81%E7%9A%84-node.js-%E5%BA%93) ----------------------------------------------------------------------------------------------------------------------------------------------------------- 首先，导入必要的 Node.js 库并设置你的环境变量。 const cryptoJS = require('crypto-js'); // Import encryption modules for subsequent encryption calculations const { Web3 } = require('web3'); // Import the Web3 library for interacting with Ethereum const fetch = (...args) => import('node-fetch').then(({ default: fetch }) => fetch(...args)); // Import the fetch library for making HTTP requests 2\. 设置你的环境变量[#](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#2.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F) ------------------------------------------------------------------------------------------------------------------------------------------------------------- 定义后续请求和 API URL 的基本变量，并初始化 Web3。Web3 是一组库，允许你使用 HTTP、IPC 或 WebSocket 与本地或远程以太坊节点进行交互。 const apiBaseUrl = 'https://web3.okx.com/'; // Define the underlying path of the request const web3RpcUrl = 'https://.....pro'; // The URL for the Ethereum node you want to connect to const privateKey = '0x...xxx'; // Set the private key of your wallet (replace '0x...xxx' with your actual private key). NEVER SHARE THIS WITH ANYONE! const chainId = '1'; const fromTokenAddress = '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'; // Native token address const toTokenAddress = '0xdac17f958d2ee523a2206206994597c13d831ec7'; const userWalletAddress = '0x...35'; // User wallet address const secretKey = '31...D2'; // The key obtained from the previous application const apiKey = '42d0fd46-6f11-4681-a64a-9ba17d99d406'; // The api Key obtained from the previous application const passphrase = '*********'; // The password created when applying for the key const date = new Date(); // Get the current time const timestamp = date.toISOString(); // Convert the current time to the desired format const web3 = new Web3(new Web3.providers.HttpProvider(web3RpcUrl)); //Establishing web3 link 3\. 定义辅助函数[#](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#3.-%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) ----------------------------------------------------------------------------------------------------------------------------------------- 定义将用于与 欧易 API 交互的辅助函数。 // Construct full API request URL const getRequestUrl = (apiBaseUrl, api, queryParams) => { return apiBaseUrl + api + '?' + new URLSearchParams(queryParams).toString(); }; const apiRequestUrl = getRequestUrl(apiBaseUrl, '/swap', swapParams); 4\. 组装头部参数[#](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#4.-%E7%BB%84%E8%A3%85%E5%A4%B4%E9%83%A8%E5%8F%82%E6%95%B0) ----------------------------------------------------------------------------------------------------------------------------------------- 设置头部属性。除了 apiRequestUrl 参数外，所有其他参数都是通用的，而 apiRequestUrl 参数是基于不同请求生成的。 const headersParams = { 'Content-Type': 'application/json', 'OK-ACCESS-KEY': apiKey, 'OK-ACCESS-SIGN': cryptoJS.enc.Base64.stringify( cryptoJS.HmacSHA256(timestamp + 'GET' + '/api/v5/dex/aggregator/xxx?xxx=xxx', secretKey) ), 'OK-ACCESS-TIMESTAMP': timestamp, 'OK-ACCESS-PASSPHRASE': passphrase, }; [REST API 鉴权](https://web3.okx.com/zh-hans/build/docs/waas/rest-authentication) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 目录 [1\. 导入必要的 Node.js 库](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#1.-%E5%AF%BC%E5%85%A5%E5%BF%85%E8%A6%81%E7%9A%84-node.js-%E5%BA%93) [2\. 设置你的环境变量](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#2.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F) [3\. 定义辅助函数](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#3.-%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) [4\. 组装头部参数](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#4.-%E7%BB%84%E8%A3%85%E5%A4%B4%E9%83%A8%E5%8F%82%E6%95%B0) --- # 更新账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) 更新账户 更新账户[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account#%E6%9B%B4%E6%96%B0%E8%B4%A6%E6%88%B7) =============================================================================================================================== 更改某一钱包账户下绑定的地址。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/account/update-wallet-account` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | accountId | String | Yes | 账户的唯一标识 | | updateType | String | Yes | `add`: 添加
`delete`: 删除 | | addresses | Array | Yes | 地址列表。（单次调用最多50个地址） | | \>chainIndex | String | Yes | 链唯一标识 | | \>address | String | Yes | 地址 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 无 [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/account/update-wallet-account' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "accountId": "13886e05-1265-4b79-8ac3-b7ab46217655", "updateType": "add", "addresses": [\ {\ "chainIndex":"1",\ "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db",\ },{\ "chainIndex":"0",\ "address":"bc1p939endmmt6pvz7ukeywpfsazz57cc4vdu3d0qerz6crhgrtmerfssls5wy",\ }\ ], }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [], "msg": "success" } [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) --- # 常用参数定义 | 资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) [常用参数定义](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) [查看 chainIndex](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-errorcode) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) 常用参数定义 常用参数定义[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#%E5%B8%B8%E7%94%A8%E5%8F%82%E6%95%B0%E5%AE%9A%E4%B9%89) =============================================================================================================================================== 我们汇总了你在调用钱包 API 服务时会遇到的一些常用参数，你可以了解他们的定义及使用场景。 accountId[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#accountid) ----------------------------------------------------------------------------------------------------- accountId 是钱包 API 为账户所赋予的唯一标识。其功能是可以关联多链多地址，进行资产及交易历史等数据的聚合查询。 chainIndex[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#chainindex) ------------------------------------------------------------------------------------------------------- chainIndex 是钱包 API 服务内，对链的唯一标识。除了遵循 EVM 架构的 EIP-155 协议的标准 chainIndex。部分链如 BTC、Solana 等由于并没有统一的 ID 规范，我们使用 BIP44 规范中的 cointype 参数来作为链标识。其他特殊情况下，我们会与已有 ID 进行去重确认后再分配。chainIndex 示例如下： | 区块链网络 | chainIndex | eip155chainId | | --- | --- | --- | | Bitcoin Mainnet | 0 | | | Ethereum Mainnet | 1 | 1 | | OP Mainnet | 10 | 10 | | ZKSpace | 13 | | | Flare Mainnet | 14 | 14 | | Cronos Mainnet | 25 | 25 | 点击 [这里](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) 可以查阅完整的区块链网络支持情况和对应的chainIndex。 orderId[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#orderid) ------------------------------------------------------------------------------------------------- orderId，是钱包 API 系统内部内为对每一笔交易赋予的唯一标识。使用 orderId 查询，即使交易未上链，系统内也会记录，确保交易全流程可见。 [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) [查看 chainIndex](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) 目录 [accountId](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#accountid) [chainIndex](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#chainindex) [orderId](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#orderid) --- # Javascript 签名 SDK | 签名 SDK | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [Javascript 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk) [Go 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) Javascript 签名 SDK Javascript 签名 SDK[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#javascript-%E7%AD%BE%E5%90%8D-sdk) ======================================================================================================================================= 概述[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%A6%82%E8%BF%B0) --------------------------------------------------------------------------------------------------------- Js-wallet-sdk 是一个基于 TypeScript/JavaScript 语言的钱包解决方案，包括了各条公链不同的密码学算法和常用功能，可以使用它离线进行私钥、地址的创建，组装交易，以及进行签名等等。本文档将详细介绍如何使用此 SDK。目前，它已经支持各种主流的区块链，每种币种类别都有独立的模块实现，我们将在未来持续增加对更多区块链的支持。 ### 支持平台[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%94%AF%E6%8C%81%E5%B9%B3%E5%8F%B0) 作为一个 Javascript SDK，它支持各种浏览器和 JavaScript 环境，可以轻松地集成到 Web 应用、移动应用或桌面应用中。 安装和构建[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E5%AE%89%E8%A3%85%E5%92%8C%E6%9E%84%E5%BB%BA) --------------------------------------------------------------------------------------------------------------------------------------- ### NPM 构建[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#npm-%E6%9E%84%E5%BB%BA) 要使用签名 SDK，首先需要安装它，你可以使用 npm 安装来获取到最新版本。 我们的签名 SDK 支持两种类型的包：公共包和单币种模块。 公共包，针对所有币种： npm install @okxweb3/crypto-lib npm install @okxweb3/coin-base 集成单个币种，以 ETH 和 BTC 为例： 集成 ETH: npm install @okxweb3/coin-ethereum 集成 BTC: npm install @okxweb3/coin-bitcoin ### 本地构建[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%9C%AC%E5%9C%B0%E6%9E%84%E5%BB%BA) 在本地构建 SDK： 1. 下载项目源码 git clone https://github.com/okx/js-wallet-sdk.git 2. 运行构建脚本 sh build.sh 主要功能[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E4%B8%BB%E8%A6%81%E5%8A%9F%E8%83%BD) ----------------------------------------------------------------------------------------------------------------------------- 以下是签名 SDK 中每个模块的具体功能介绍。 * crypto-lib: 这个模块提供了常用的安全加密算法和签名算法等。 * coin-base: 这个模块提供了币种通用接口。 * coin-\*: 这个模块实现了各个币种交易构建和签名的方法。每种币种都有一个对应的模块，例如 coin-ethereum、coin-bitcoin 等。这些模块提供了针对特定币种的交易构建和签名方法。 Packages[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#packages) ----------------------------------------------------------------------------------------------------- | 包名 | 模块 | 描述 | | --- | --- | --- | | [@okxweb3/coin-base](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-base/README.md) | coin-base | 我们为这些链或币种提供通用功能，使得访问这些链变得非常简单。 | | [@okxweb3/crypto-lib](https://github.com/okx/js-wallet-sdk/blob/main/packages/crypto-lib/README.md) | crypto-lib | 我们提供关于 bip32、bip39、ecdsa、ed25519 等的通用函数。 | | [@okxweb3/coin-aptos](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-aptos/README.md) | coin-aptos | Aptos SDK 用于与 Aptos 区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-bitcoin](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-bitcoin/README.md) | coin-bitcoin | Bitcoin SDK 用于与 Bitcoin 主网或测试网交互，包含可用于 web3 钱包的各种函数。SDK 不仅支持 Bitcoin，还支持以下链：BTC,BSV,DOGE,LTC,TBTC | | [@okxweb3/coin-cosmos](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-cosmos/README.md) | coin-cosmos | Cosmos SDK 用于与 Cosmos 区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-eos](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-eos/README.md) | coin-eos | EOS SDK 用于与 EOS 区块链交互，包含可用于 web3 钱包的各种函数。SDK 不仅支持 EOS，还支持 WAX。 | | [@okxweb3/coin-ethereum](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-ethereum/README.md) | coin-ethereum | Ethereum SDK 用于与Ethereum 区块链或 EVM 区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-flow](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-flow/README.md) | coin-flow | Flow SDK 用于与 Flow 区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-near](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-near/README.md) | coin-near | Near SDK 用于与 Near 协议交互，包含与 Near 生态系统交互时需要的主要函数。 | | [@okxweb3/coin-polkadot](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-polkadot/README.md) | coin-polkadot | Polkadot SDK 用于与 Polkadot 区块链交互，包含与 Polkadot 生态系统交互时需要的主要函数。 | | [@okxweb3/coin-solana](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-solana/README.md) | coin-solana | Solana SDK 用于与 Solana 链交互，包含与 Solana 生态系统交互时需要的主要函数。 | | [@okxweb3/coin-stacks](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-stacks/README.md) | coin-stacks | Stacks SDK 用于与 Stacks 区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-starknet](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-starknet/README.md) | coin-starknet | Starknet SDK 用于与 Starknet 区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-sui](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-sui/README.md) | coin-sui | SUI SDK 用于与 SUI 区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-tron](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-tron/README.md) | coin-tron | TRX SDK 用于与TRON区块链交互，包含可用于 web3 钱包的各种函数。 | | [@okxweb3/coin-zkspace](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-zkspace/README.md) | coin-zkspace | ZKSpace SDK 用于与 ZK 合约交互，包含可用于 web3 钱包的各种函数。SDK 不仅支持 ZKSpace，还支持 zkSync。 | ### coin-base[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-base) base 包是所有币种的公共基础模块，提供币种通用的接口方法定义，例如：随机生成私钥、私钥派生、获取派生路径等。目前，单币种的实现包基本实现了通用的接口方法，不同币种支持的功能函数略有不同，具体可以参考各币种实现包的功能函数说明。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-base 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签名交易 | | | getDerivedPath | 获取 bip44 路径 | | | validPrivateKey | 验证私钥 | | | signMessage | 签名消息 | | | verifyMessage | 验证签名消息 | | | ecRecover | 恢复签名到公钥 | | | getAddressByPublicKey | 通过公钥获取地址 | | | getHardWareRawTransaction | 获取硬件的原始交易 | | | getHardWareSignedTransaction | 获取硬件的签名交易 | | | getHardWareMessageHash | 获取硬件的消息哈希 | | | calcTxHash | 通过原始交易获取交易哈希 | | | getRawTransaction | 生成原始交易数据 | | | validSignedTransaction | 检查签名交易 | | | estimateFee | 估计燃气费 | | 关于 coin-base 包支持的功能函数和使用案例，更详细的内容可以查看 github 文档：[coin-base功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-base/README.md#supporting-functions) 。 ### crypto-lib[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#crypto-lib) 这是一个包含了 bip32, bip39, ecdsa, ed25519 等常用的安全加密和签名算法的实现，例如： * bip32 常用函数：这些函数主要用于处理和操作比特币改进型支付协议（BIP32）相关的任务。 * bip39 生成助记词、公私钥、签名消息函数：这些函数主要用于处理和操作比特币改进型支付协议（BIP39）相关的任务，如生成助记词，公私钥，以及签名消息。 * 常用的哈希和编解码函数：这些函数主要用于处理常见的哈希和编解码任务，如 SHA256 哈希，Base64 编解码等。 * ed5519 常用签名函数：这些函数主要用于处理和操作 ed5519 签名算法相关的任务。 * ecds 常用签名函数：这些函数主要用于处理和操作椭圆曲线数字签名算法（ECDSA）相关的任务。 通过 npm 获取最新版本的包： npm install @okxweb3/crypto-lib 关于 crypto-lib 包支持的功能函数和使用案例，更详细的内容可以查看 github 文档：[crypto-lib功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/crypto-lib/README.md#provides) 。 ### coin-aptos[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-aptos) Aptos SDK 主要用集成 Aptos 区块链，包含有私钥生成、私钥派生、生成地址、交易转帐等功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-aptos 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成一个随机的私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新的地址 | | | validAddress | 验证地址的有效性 | | | signTransaction | 对交易进行签名 | | | getDerivedPath | 获取 bip44 路径 | | | signMessage | 对消息进行签名 | | | verifyMessage | 验证签名消息的有效性 | | | calcTxHash | 通过原始交易获取交易哈希 | | | validSignedTransaction | 检查已签名的交易的有效性 | | Aptos 交易支持类型有： "transfer"、"tokenTransfer"、"tokenMint"、"tokenBurn"、"tokenRegister"、"dapp"、"simulate"、"offerNft"、"claimNft"、"offerNft\_simulate"、"claimNft\_simulate" 关于 coin-aptos 包支持的功能函数和使用案例，可以查看 github 文档以获取更详细的内容：[coin-aptos功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-aptos/README.md#usage) 。 ### coin-bitcoin[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-bitcoin) coin-bitcoin 是一个用于集成 Bitcoin 区块链的 SDK，它支持 Bitcoin 的主网和测试网，并提供了一系列的功能函数，使开发者能够更方便地与 Bitcoin 区块链进行交互。除了 BTC，它还支持 BSV、DOGE、LTC 和 TBTC 等币种。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-bitcoin 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成一个随机的私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新的地址 | | | validAddress | 验证地址的有效性 | | | signTransaction | 对交易进行签名 | | | getDerivedPath | 获取 bip44 路径 | | | signMessage | 对消息进行签名 | | | verifyMessage | 验证签名消息的有效性 | | | calcTxHash | 通过原始交易获取交易哈希 | | | validSignedTransaction | 检查已签名的交易的有效性 | | | getAddressByPublicKey | 通过公钥获取地址 | | 关于 coin-bitcoin 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-bitcoin功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-bitcoin/README.md#using-bitcoin-sdk) 。 ### coin-cosmos[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-cosmos) Cosmos SDK 是一个用于集成 Cosmos 架构的区块链的工具包，它提供了一系列的功能函数，包括生成私钥、派生私钥、生成地址和交易转账等。它支持的币种包括： * Atom * Axelar * Cronos * Evmos * Iris * Juno * Kava * Kujira * Osmos * Secret * Sei * Stargaze * Terra 通过 npm 获取最新版本的包： npm install @okxweb3/coin-cosmos 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | signMessage | 签署消息 | | | verifyMessage | 验证签署的消息 | | | calcTxHash | 通过原始交易获取交易哈希 | | | validSignedTransaction | 检查已签署的交易 | | | getAddressByPublicKey | 通过公钥获取地址 | | 关于 coin-cosmos 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-cosmos功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-cosmos/README.md#using-cosmos-sdk) 。 ### coin-eos[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-eos) EOS SDK 是一个用于集成 EOS 区块链的工具包，它提供了一系列的功能函数，包括生成私钥、派生私钥、生成地址和交易序列化等。除了 EOS 外，它还支持 Wax 币种。 这些功能函数使开发者能够更方便地与 EOS 区块链进行交互，包括创建和管理钱包，发送和接收交易，以及查询区块链信息等。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-eos 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | calcTxHash | 通过原始交易获取交易哈希 | | 关于 coin-eos 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-eos功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-eos/README.md#using-eos-sdk) 。 ### coin-ethereum[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-ethereum) Ethereum SDK 是一个用于集成 Ethereum 区块链和其他 支持EVM (以太坊虚拟机) 的区块链的工具包。它提供了一系列的功能函数，包括生成私钥、派生私钥、生成地址和交易转账等。 这些功能函数使开发者能够更方便地与 Ethereum 区块链进行交互，包括创建和管理钱包，发送和接收交易，以及查询区块链信息等。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-ethereum 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | validPrivateKey | 验证私钥 | | | signMessage | 签署消息 | | | verifyMessage | 验证签署的消息 | | | ecRecover | 恢复签名到公钥 | | | getAddressByPublicKey | 通过公钥获取地址 | | | getHardWareRawTransaction | 获取硬件的原始交易 | | 关于 coin-ethereum 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-ethereum功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-ethereum/README.md#using-ethereum-sdk) 。 ### coin-flow[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-flow) Flow 区块链是一个新一代的、面向未来的区块链平台，它专为高性能应用和游戏而设计。 Flow SDK 是一个用于集成 Flow 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-flow 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | validateAddress | 验证地址 | | | signTransaction | 签署交易 | | Flow 交易支持类型有：Account 和 Transfer 关于 coin-flow 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-flow 功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-flow/README.md#using-flow-sdk) 。 ### coin-near[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-near) Near 协议是一个可扩展的区块链平台，它通过使用新颖的共识机制和分片技术，实现了高吞吐量和低延迟的交易处理。Near SDK 使开发者能够更方便地开发和部署在 Near 区块链上的应用。 Near SDK 是一个用于集成 Near 协议的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-near 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getAddress | 通过种子获取地址 | | | validateAddress | 验证地址 | | | signTransaction | 签署交易 | | | transfer | 转账 | | | fullAccessKey | 获取完全访问密钥 | | | publicKeyFromSeed | 从种子获取公钥 | | 关于 coin-near 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-near功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-near/README.md#using-near-sdk) 。 ### coin-polkadot[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-polkadot) Polkadot 是一个多链异构的区块链平台，它允许各种区块链网络以共享的安全模型并行运行，同时还能实现链与链之间的信息和价值的无缝转移。 Polkadot SDK 是一个用于集成 Polkadot 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-polkadot 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getAddress | 通过种子获取地址 | | | validateAddress | 验证地址 | | | SignTx | 签署交易 | | 关于 coin-polkadot 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-polkadot 功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-polkadot/README.md#using-polkadot-sdk) 。 ### coin-solana[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-solana) Solana 是一个高性能的区块链平台，它通过创新的共识算法和区块产生机制，实现了高吞吐量和低延迟的交易处理。 Solana SDK 是一个用于集成 Solana 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-solana 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | signMessage | 签署消息 | | | calcTxHash | 通过原始交易获取交易哈希 | | | validSignedTransaction | 检查已签署的交易 | | | getHardWareRawTransaction | 获取硬件的原始交易 | | | getHardWareSignedTransaction | 获取硬件的已签署交易 | | | getHardWareMessageHash | 获取硬件的消息哈希 | | 关于 coin-solana 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-solana功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-solana/README.md#using-solana-sdk) 。 ### coin-stacks[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-stacks) Stacks 是一个开源的区块链平台，它允许开发者在 Stacks 区块链上构建智能合约和去中心化应用。 Stacks SDK 主要用集成 Stacks 区块链，包含多种用于集成 web3 钱包的功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-stacks 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | signMessage | 签署消息 | | | verifyMessage | 验证签名消息 | | | calcTxHash | 通过原始交易获取交易哈希 | | | getRawTransaction | 获取原始交易 | | 关于 coin-stacks 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-stacks 功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-stacks/README.md#using-stacks-sdk) 。 ### coin-starknet[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-starknet) StarkNet 是一个去中心化的、可扩展的区块链网络，它使用了零知识证明技术来提高交易处理的效率和安全性。 StarkNet SDK 是一个用于集成 StarkNet 区块链的工具包，它提供了一系列的功能函数，使开发者能够更方便地与 StarkNet 区块链进行交互。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-starknet 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | signMessage | 签署消息 | | | verifyMessage | 验证签名消息 | | 关于 coin-starknet 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-starknet 功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-starknet/README.md#using-starknet-sdk) 。 ### coin-sui[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-sui) SUI SDK 是一个用于集成 SUI 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-sui 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | signMessage | 签署消息 | | | calcTxHash | 通过原始交易获取交易哈希 | | 提示 注意：与 secp256k1 不同的是，ed25519 的私钥派生只支持 hard 模式的派生，详情参见：[https://github.com/satoshilabs/slips/blob/master/slip-0010.md](https://github.com/satoshilabs/slips/blob/master/slip-0010.md) 关于 coin-sui 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-sui 功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-sui/README.md#usage) 。 ### coin-tron[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-tron) TRON SDK 是一个用于集成 TRON 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-tron 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | validPrivateKey | 验证私钥 | | | signMessage | 签署消息 | | | verifyMessage | 验证签名消息 | | | ecRecover | 恢复签名到公钥 | | | getAddressByPublicKey | 通过公钥获取地址 | | | getHardWareRawTransaction | 获取硬件的原始交易 | | | getHardWareSignedTransaction | 获取硬件的签名交易 | | | getHardWareMessageHash | 获取硬件的消息哈希 | | | calcTxHash | 通过原始交易获取交易哈希 | | | getRawTransaction | 生成原始交易数据 | | | validSignedTransaction | 检查签名交易 | | 关于 coin-tron 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-tron 功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-tron/README.md#using-trx-sdk) 。 ### coin-zkspace[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#coin-zkspace) ZKSpace SDK 主要用集成 ZK 合约，包含多种用于集成 web3 钱包的功能函数，除了 ZKSpace 外，还支持 zkSync。 通过 npm 获取最新版本的包： npm install @okxweb3/coin-zkspace 支持函数： | 函数名称 | 功能 | 备注 | | --- | --- | --- | | getRandomPrivateKey | 生成随机私钥 | | | getDerivedPrivateKey | 从 DerivePriKeyParams 生成私钥 | | | getNewAddress | 通过私钥获取新地址 | | | validAddress | 验证地址 | | | signTransaction | 签署交易 | | | getDerivedPath | 获取 bip44 路径 | | | validPrivateKey | 验证私钥 | | | signMessage | 签署消息 | | | verifyMessage | 验证签名消息 | | | ecRecover | 恢复签名到公钥 | | | getAddressByPublicKey | 通过公钥获取地址 | | | getHardWareRawTransaction | 获取硬件的原始交易 | | | getHardWareSignedTransaction | 获取硬件的签名交易 | | | getHardWareMessageHash | 获取硬件的消息哈希 | | | calcTxHash | 通过原始交易获取交易哈希 | | | getRawTransaction | 生成原始交易数据 | | 交易签名支持 data 类型有：transfer 和 changePubkey 关于 coin-zkspace 包支持的功能函数和使用案例，更加详细内容可以查看 github 文档：[coin-zkspace 功能函数](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-zkspace/README.md#using-zkspace-sdk) 。 测试用例[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B) ----------------------------------------------------------------------------------------------------------------------------- 在 github 上，每个模块对应的 package 下有一个 `tests` 目录，放有各个币种模块的测试用例，可以通过测试用例了解到更多关于 SDK 中函数的用法。 | 币种 | 测试用例 | 备注 | | --- | --- | --- | | BTC | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-bitcoin/tests/btc.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-bitcoin/tests/btc.test.ts) | | | ETH | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-ethereum/tests/eth.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-ethereum/tests/eth.test.ts) | | | Cosmos | [https://github.com/okx/js-wallet-sdk/tree/main/packages/coin-cosmos/tests](https://github.com/okx/js-wallet-sdk/tree/main/packages/coin-cosmos/tests) | | | Aptos | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-aptos/tests/aptos.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-aptos/tests/aptos.test.ts) | | | EOS | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-eos/tests/eos.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-eos/tests/eos.test.ts) | | | Solana | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-solana/tests/sol.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-solana/tests/sol.test.ts) | | | Stacks | [https://github.com/okx/js-wallet-sdk/tree/main/packages/coin-stacks/tests](https://github.com/okx/js-wallet-sdk/tree/main/packages/coin-stacks/tests) | | | Starknet | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-starknet/tests/crypto.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-starknet/tests/crypto.test.ts) | | | SUI | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-sui/tests/crypto.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-sui/tests/crypto.test.ts) | | | TRON | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-tron/tests/trx.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-tron/tests/trx.test.ts) | | | ZKSpace | [https://github.com/okx/js-wallet-sdk/tree/main/packages/coin-zkspace/tests](https://github.com/okx/js-wallet-sdk/tree/main/packages/coin-zkspace/tests) | | | Flow | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-flow/tests/flow.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-flow/tests/flow.test.ts) | | | Near | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-near/tests/near.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-near/tests/near.test.ts) | | | Polkadot | [https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-polkadot/tests/dot.test.ts](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-polkadot/tests/dot.test.ts) | | 支持币种[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%94%AF%E6%8C%81%E5%B8%81%E7%A7%8D) ----------------------------------------------------------------------------------------------------------------------------- | 币族 | 币种 | 派生路径 | | --- | --- | --- | | BTC | BTC | 常规地址：
m/44'/0'/0/0'/0
隔离见证：
m/49'/0'/0/0'/0
m/84'/0'/0/0'/0
m/86'/0'/0/0'/0 | | BTC | BCH | m/44'/145'/0'/0/0 | | BTC | BSV | m/44'/236'/0'/0/0 | | BTC | LTC | m/44'/2'/0'/0/0 | | BTC | Doge | m/44'/3'/0'/0/0 | | BTC | TBTC | m/44'/0'/0/0'/0 | | BTC | Omni usdt | m/44'/0'/0/0'/0 | | ETH | ETH | m/44'/60'/0'/0/0 | | ETH | Arbitrum One | m/44'/60'/0'/0/0 | | ETH | Arbitrum Nova | m/44'/60'/0'/0/0 | | ETH | Avalanche C | m/44'/60'/0'/0/0 | | ETH | Boba | m/44'/60'/0'/0/0 | | ETH | BNB Chain | m/44'/60'/0'/0/0 | | ETH | Base | m/44'/60'/0'/0/0 | | ETH | Core | m/44'/60'/0'/0/0 | | ETH | Cronos(EVM) | m/44'/60'/0'/0/0 | | ETH | Celo | m/44'/60'/0'/0/0 | | ETH | Conflux(EVM) | m/44'/60'/0'/0/0 | | ETH | Endurance | m/44'/60'/0'/0/0 | | ETH | EthereumPoW | m/44'/60'/0'/0/0 | | ETH | EthereumFair | m/44'/60'/0'/0/0 | | ETH | Filecoin EVM | m/44'/60'/0'/0/0 | | ETH | Fantom | m/44'/60'/0'/0/0 | | ETH | Flare | m/44'/60'/0'/0/0 | | ETH | Gnosis | m/44'/60'/0'/0/0 | | ETH | Goerli | m/44'/60'/0'/0/0 | | ETH | HAQQ Network | m/44'/60'/0'/0/0 | | ETH | Klaytn | m/44'/60'/0'/0/0 | | ETH | KCC | m/44'/60'/0'/0/0 | | ETH | Kava EVM | m/44'/60'/0'/0/0 | | ETH | Linea | m/44'/60'/0'/0/0 | | ETH | Metis | m/44'/60'/0'/0/0 | | ETH | Moonebeam | m/44'/60'/0'/0/0 | | ETH | Moonriver | m/44'/60'/0'/0/0 | | ETH | Mantle | m/44'/60'/0'/0/0 | | ETH | Omega Network | m/44'/60'/0'/0/0 | | ETH | OKTC | m/44'/60'/0'/0/0 | | ETH | Optimism | m/44'/60'/0'/0/0 | | ETH | opBNB | m/44'/60'/0'/0/0 | | ETH | Polygon | m/44'/60'/0'/0/0 | | ETH | Polygon zkEVM | m/44'/60'/0'/0/0 | | ETH | PulseChain | m/44'/60'/0'/0/0 | | ETH | Sepolia | m/44'/60'/0'/0/0 | | ETH | zkSync Era | m/44'/60'/0'/0/0 | | ETH | ZetaChian | m/44'/60'/0'/0/0 | | Cosmos | Atom | m/44'/118'/0'/0/0 | | Cosmos | Axelar | m/44'/118'/0'/0/0 | | Cosmos | Cronos | m/44'/394'/0'/0/0 | | Cosmos | Osmos | m/44'/118'/0'/0/0 | | Cosmos | Evmos | m/44'/60'/0'/0/0 | | Cosmos | Iris | m/44'/118'/0'/0/0 | | Cosmos | Juno | m/44'/118'/0'/0/0 | | Cosmos | Kava | m/44'/459'/0'/0/0 | | Cosmos | Kujira | m/44'/118'/0'/0/0 | | Cosmos | Secret | m/44'/529'/0'/0/0 | | Cosmos | Sei | m/44'/118'/0'/0/0 | | Cosmos | Stargaze | m/44'/118'/0'/0/0 | | Cosmos | Terra | m/44'/330'/0'/0/0 | | Aptos | Aptos | m/44'/637'/0'/0/0 | | EOS | EOS | m/44'/194'/0'/0/0 | | Solana | Solana | m/44'/501'/0'/0/0 | | Stacks | Stacks | m/44'/5757'/0'/0/0 | | ETH layer 2 | Starknet | m/44'/9004'/0'/0/0 | | SUI | SUI | m/44'/784'/0'/0/0 | | TRX | TRON | m/44'/195'/0'/0/0 | | ETH layer 2 | ZKSpace | m/44'/60'/0'/0/0 | | ETH layer 2 | zkSync | m/44'/60'/0'/0/0 | [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [Go 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk) 目录 [概述](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%A6%82%E8%BF%B0) [安装和构建](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E5%AE%89%E8%A3%85%E5%92%8C%E6%9E%84%E5%BB%BA) [主要功能](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E4%B8%BB%E8%A6%81%E5%8A%9F%E8%83%BD) [Packages](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#packages) [测试用例](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B) [支持币种](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk#%E6%94%AF%E6%8C%81%E5%B8%81%E7%A7%8D) --- # Ordinals 相关模型 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) Ordinals 相关模型 Ordinals 相关模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model#ordinals-%E7%9B%B8%E5%85%B3%E6%A8%A1%E5%9E%8B) ======================================================================================================================================= Ordinals 合集模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model#ordinals-%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------------------------------------------- | **参数** | **类型** | **描述** | | --- | --- | --- | | slug | String | 合集 slug 名称，即合集的唯一标识 | | totalVolume | String | 合集总交易额，BTC 计价 | | floorPrice | String | 合集地板价，BTC 计价 | | inscriptionNumRange | String | 合集铭文编号范围 | | volume24h | String | 合集24小时交易额，BTC计价 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT | Ordinals 订单模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model#ordinals-%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------------------------------------------- | **参数** | **类型** | **描述** | | --- | --- | --- | | inscriptionId | String | 铭文编号 | | listingTime | Long | 挂单时间 | | listingUrl | String | 订单所在页面链接 | | ownerAddress | String | 订单所有者 | | price | String | 订单价格，BTC 计价 | | unitPrice | String | 订单单价，BTC计价 | | amount | String | 订单中的铭文数量 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT | Ordinals 交易历史模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model#ordinals-%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2%E6%A8%A1%E5%9E%8B) ----------------------------------------------------------------------------------------------------------------------------------------------------------- | **参数** | **类型** | **描述** | | --- | --- | --- | | fromAddress | String | 交易 From 地址 | | inscriptionId | String | 铭文编号 | | price | String | 交易价格，BTC 计价 | | timestamp | Long | 交易时间戳 | | toAddress | String | 交易 To 地址 | | unitPrice | String | 订单单价，BTC 计价 | | amount | String | 订单中的铭文数量 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT | [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) 目录 [Ordinals 合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model#ordinals-%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B) [Ordinals 订单模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model#ordinals-%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) [Ordinals 交易历史模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model#ordinals-%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2%E6%A8%A1%E5%9E%8B) --- # 提交挂单 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Runes API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) 提交挂单 提交挂单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing#%E6%8F%90%E4%BA%A4%E6%8C%82%E5%8D%95) ============================================================================================================================ 该接口用于将单个Runes铭文挂单到 OKX 平台。在挂单前，您可通过该接口[获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) （获取钱包对某一代币的持有信息）先获取您持有的Runes铭文列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/runes/make-order` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **字段名** | **类型** | **是否必传** | **说明** | | --- | --- | --- | --- | | runesId | String | 是 | runes 代币的唯一标识，例如：840000:3 | | walletAddress | String | 是 | 持有上述 runesId 铭文的钱包地址 | | utxo | String | 是 | rune 代币所在的 UTXO，格式为：txHash:vout，例如：d578a0967605257f75be625cbdc2506f2a52f9135f56f302badab6a3da54e0d4:0 | | unitPrice | BigDecimal | 是 | 铭文挂单单价，单位为聪 | | totalPrice | BigDecimal | 是 | 铭文挂单总价，单位为 BTC | | psbt | String | 是 | 签名后的挂单 PSBT，目前只接受 base64 编码的 psbt，需要将铭文所在的 utxo 放在输入的 index=1 的位置，收款地址和金额放在对应输出的 index=1 的位置 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | **字段名** | **类型** | **说明** | | --- | --- | --- | | code | Integer | 响应结果码，code=0 代表成功， 其他代表失败 | | data | Object | 响应结果体，具体字段参考响应示例 | | msg | String | 结果提示，code不为0时可参考 | [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/mktplace/nft/runes/make-order' \ --header 'OK-ACCESS-KEY: your apikey' \ --header 'OK-ACCESS-PASSPHRASE: your passphrase' \ --header 'Content-Type: application/json' \ --data '{ "runesId": "840000:3", "walletAddress": "bc1pud5f80a06y6jcwlllt2t5vdq24sd8d24f39jccay24dqhqmgelkq9dqghx", "utxo": "c1dd6736a19d7744353731c85f7f3b7fb9908041e03a1fe66507102e5af930ec:2", "unitPrice": 130000, "totalPrice": 1300000, "psbt": "j2li1jlkjsalkdfjsalkjdo" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, //code=0代表成功， 其他代表失败 "data": { "assetId": "1", //挂单的资产id }, "msg": "" } [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) --- # 查看 chainIndex | 资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) [常用参数定义](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) [查看 chainIndex](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-errorcode) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) 查看 chainIndex 查看 chainIndex[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks#%E6%9F%A5%E7%9C%8B-chainindex) ==================================================================================================================================== 注意 chainIndex：是由钱包 API 服务自定义的唯一标识，少部分会与 EIP-155 的 chainId 有差异。 EIP-155 chainId：[EIP-155](https://eips.ethereum.org/EIPS/eip-155) 中指定的 chainId。你可以通过[此链接](https://chainid.network/) 查看详细的 chainId 信息。 | 序号 | 网络名称 | chainIndex | 是否支持 | | --- | --- | --- | --- | | 1 | BTC | 0 | 已经支持 | | 2 | Ethereum | 1 | 已经支持 | | 3 | Litecoin | 2 | 已经支持 | | 4 | Dogecoin | 3 | 已经支持 | | 5 | Dash | 5 | 已经支持 | | 6 | Optimism | 10 | 已经支持 | | 7 | Flare | 14 | 已经支持 | | 8 | Cronos | 25 | 已经支持 | | 9 | BNB Smart Chain | 56 | 已经支持 | | 10 | Ethereum Classic | 61 | 已经支持 | | 11 | OKTC | 66 | 已经支持 | | 12 | Gnosis | 100 | 已经支持 | | 13 | Polygon | 137 | 已经支持 | | 14 | Bitcoin Cash | 145 | 已经支持 | | 15 | Manta Pacific | 169 | 已经支持 | | 16 | Tron | 195 | 已经支持 | | 17 | X layer | 196 | 已经支持 | | 18 | opBNB | 204 | 已经支持 | | 19 | B^2 network | 223 | 已经支持 | | 20 | Fantom | 250 | 已经支持 | | 21 | Kroma | 255 | 已经支持 | | 22 | KCC | 321 | 已经支持 | | 23 | zkSync Era | 324 | 已经支持 | | 24 | PulseChain | 369 | 已经支持 | | 25 | Omega Network | 408 | 已经支持 | | 26 | Endurance | 648 | 已经支持 | | 27 | Conflux | 1030 | 已经支持 | | 28 | Metis | 1088 | 已经支持 | | 29 | Polygon zkEVM | 1101 | 已经支持 | | 30 | Core | 1116 | 已经支持 | | 31 | Moonbeam | 1284 | 已经支持 | | 32 | Moonriver | 1285 | 已经支持 | | 33 | Ronin | 2020 | 已经支持 | | 34 | Rangers | 2025 | 已经支持 | | 35 | Kava EVM | 2222 | 已经支持 | | 36 | Merlin Chain | 4200 | 已经支持 | | 37 | Mantle | 5000 | 已经支持 | | 38 | Base | 8453 | 已经支持 | | 39 | Immutable zkEVM | 13371 | 已经支持 | | 40 | MODE\_ETH | 34443 | 已经支持 | | 41 | Arbitrum One | 42161 | 已经支持 | | 42 | Arbitrum Nova | 42170 | 已经支持 | | 43 | Celo | 42220 | 已经支持 | | 44 | Avalanche C | 43114 | 已经支持 | | 45 | Linea | 59144 | 已经支持 | | 46 | Kaia network (Klaytn) | 8217 | 已经支持 | | 47 | Blast | 81457 | 已经支持 | | 48 | Chilizi | 88888 | 不支持 | | 49 | EthereumPoW | 10001 | 已经支持 | | 50 | TAIKO\_ETH | 167000 | 已经支持 | | 51 | BITLAYER\_BTC | 200901 | 已经支持 | | 52 | Ethereum Fair(DIS chain) | 513100 | 已经支持 | | 53 | BOB\_ETH | 60808 | 已经支持 | | 54 | Scroll | 534352 | 已经支持 | | 55 | Sepolia | 11155111 | 已经支持 | | 56 | Fractal Bitcoin Mainnet | 70000061 | 已经支持 | | 57 | Solana | 501 | 已经支持 | | 58 | SUI | 784 | 已经支持 | | 59 | Gravity | 1625 | 已经支持 | | 60 | Wemix | 1111 | 已经支持 | | 61 | Lumi | 94168 | 已经支持 | | 62 | Sonic | 146 | 已经支持 | [常用参数定义](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-errorcode) --- # 交易广播 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) 交易广播 交易广播[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction#%E4%BA%A4%E6%98%93%E5%B9%BF%E6%92%AD) ========================================================================================================================== 将交易广播到链上。 交易广播 API 仅向我们的企业客户提供。如果您感兴趣，请联系我们： [dexapi@okx.com](mailto:dexapi@okx.com) ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/pre-transaction/broadcast-transaction` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | signedTx | String | Yes | 完成签名的交易字符串 | | chainIndex | String | Yes | 链唯一标识, e.g. ETH=3 详情见 链的唯一标识整理 | | address | String | Yes | 地址。 | | accountId | String | No | 钱包账户 Id。后续可用于查看账户下发的交易 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | orderId | String | 交易唯一标识 | [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://www.okx.com/api/v5/wallet/pre-transaction/broadcast-transaction' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "accountId": "5f45a951-4a8b-4cd9-b20a-3b337b71efcc", "chainIndex": "1", "address": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3", "signedTx": "0x02f8720182029f8411e1a3008504bbe2e94682520894d73c5e36d47eed32f0327f9d3f04b49384e90fab85e8d4a5100080c080a0ba380a9be31efabc4c8cfccbb555f8af3c21073d6eca01f180ebebb8942c6f30a0779e6e16a504c413cb9902ceb33ab7e89a533bc13b74477dfa6b6c76dc41fac2" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "orderId": "0e1d79837afce1e149b6ab54b6e2edce8130c3f8"\ }\ ], "msg": "" } [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) --- # Go 签名 SDK | 签名 SDK | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [Javascript 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk) [Go 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) Go 签名 SDK Go 签名 SDK[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#go-%E7%AD%BE%E5%90%8D-sdk) =============================================================================================================== 概述[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E6%A6%82%E8%BF%B0) ------------------------------------------------------------------------------------------------- Go-wallet-sdk 是一个基于 Go 语言的钱包解决方案，包括了各条公链不同的密码学算法和常用功能，可以使用它离线进行私钥、地址的创建，组装交易，以及进行签名等等。本文档将详细介绍如何使用此 SDK。目前，它已经支持各种主流的区块链，每种币种类别都有独立的模块实现，我们将在未来持续增加对更多区块链的支持。 ### 支持平台[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E6%94%AF%E6%8C%81%E5%B9%B3%E5%8F%B0) 作为一个 Go SDK，可以轻松地集成到 Web 应用、移动应用或桌面应用中。 安装和构建[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E5%AE%89%E8%A3%85%E5%92%8C%E6%9E%84%E5%BB%BA) ------------------------------------------------------------------------------------------------------------------------------- ### Go GET[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#go-get) 要使用签名 SDK，首先需要安装它，你可以使用 `go get` 安装来获取到最新版本。 我们的签名 SDK 支持两种类型的包：公共包和单币种模块。 公共包，针对所有币种： go get -u github.com/okx/go-wallet-sdk/crypto 集成单个币种，以 ETH 和 BTC 为例： 集成 ETH: go get -u github.com/okx/go-wallet-sdk/coins/ethereum 集成 BTC: go get -u github.com/okx/go-wallet-sdk/coins/bitcoin 主要功能[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E4%B8%BB%E8%A6%81%E5%8A%9F%E8%83%BD) --------------------------------------------------------------------------------------------------------------------- 以下是签名 SDK 中每个模块的具体功能介绍。 * crypto: 这个模块提供了常用的安全加密算法和签名算法等。 * coins: 这个模块实现了各个币种交易构建和签名的方法。每种币种都有一个对应的模块，例如 ethereum、bitcoin 等。这些模块提供了针对特定币种的交易构建和签名方法。 Packages[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#packages) --------------------------------------------------------------------------------------------- | 包名 | 模块 | 描述 | | --- | --- | --- | | [github.com/okx/go-wallet-sdk/crypto](https://github.com/okx/go-wallet-sdk/tree/main/crypto) | crypto | 我们提供关于 bip32、bip39、ecdsa、ed25519 等的通用函数。 | | [github.com/okx/go-wallet-sdk/coins/aptos](https://github.com/okx/go-wallet-sdk/tree/main/coins/aptos) | aptos | Aptos SDK 用于与 Aptos 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/bitcoin](https://github.com/okx/go-wallet-sdk/tree/main/coins/bitcoin) | bitcoin | Bitcoin SDK 用于与 Bitcoin 主网或测试网交互，包含可用于 web3 钱包的各种函数。SDK 不仅支持 Bitcoin，还支持以下链：BTC, BSV, DOGE, LTC, TBTC。 | | [github.com/okx/go-wallet-sdk/coins/cosmos](https://github.com/okx/go-wallet-sdk/tree/main/coins/cosmos) | cosmos | Cosmos SDK 用于与 Cosmos 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/eos](https://github.com/okx/go-wallet-sdk/tree/main/coins/eos) | eos | EOS SDK 用于与 EOS 区块链交互，包含可用于 web3 钱包的各种函数。SDK 不仅支持 EOS，还支持 WAX。 | | [github.com/okx/go-wallet-sdk/coins/ethereum](https://github.com/okx/go-wallet-sdk/tree/main/coins/ethereum) | ethereum | Ethereum SDK 用于与 Ethereum 区块链或 EVM 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/flow](https://github.com/okx/go-wallet-sdk/tree/main/coins/flow) | flow | Flow SDK 用于与 Flow 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/near](https://github.com/okx/go-wallet-sdk/tree/main/coins/near) | near | Near SDK 用于与 Near 协议交互，包含与 Near 生态系统交互时需要的主要函数。 | | [github.com/okx/go-wallet-sdk/coins/polkadot](https://github.com/okx/go-wallet-sdk/tree/main/coins/polkadot) | polkadot | Polkadot SDK 用于与 Polkadot 区块链交互，包含与 Polkadot 生态系统交互时需要的主要函数。 | | [github.com/okx/go-wallet-sdk/coins/solana](https://github.com/okx/go-wallet-sdk/tree/main/coins/solana) | solana | Solana SDK 用于与 Solana 链交互，包含与 Solana 生态系统交互时需要的主要函数。 | | [github.com/okx/go-wallet-sdk/coins/stacks](https://github.com/okx/go-wallet-sdk/tree/main/coins/stacks) | stacks | Stacks SDK 用于与 Stacks 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/starknet](https://github.com/okx/go-wallet-sdk/tree/main/coins/starknet) | starknet | Starknet SDK 用于与 Starknet 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/sui](https://github.com/okx/go-wallet-sdk/tree/main/coins/sui) | sui | SUI SDK 用于与 SUI 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/tron](https://github.com/okx/go-wallet-sdk/tree/main/coins/tron) | tron | TRX SDK 用于与 TRON 区块链交互，包含可用于 web3 钱包的各种函数。 | | [github.com/okx/go-wallet-sdk/coins/zkspace](https://github.com/okx/go-wallet-sdk/tree/main/coins/zkspace) | zkspace | ZKSpace SDK 用于与 ZK 合约交互，包含可用于 web3 钱包的各种函数。SDK 不仅支持 ZKSpace，还支持 zkSync。 | ### crypto[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#crypto) 这是一个包含了 BIP32, BIP39, ECDSA, ED25519 等常用的安全加密和签名算法的实现，例如： * BIP32 常用函数：这些函数主要用于处理和操作比特币改进型支付协议 (BIP32) 相关的任务。 * BIP39 生成助记词、公私钥、签名消息函数：这些函数主要用于处理和操作比特币改进型支付协议 (BIP39) 相关的任务，如生成助记词，公私钥，以及签名消息。 * 常用的哈希和编解码函数：这些函数主要用于处理常见的哈希和编解码任务，如 SHA256 哈希，Base64 编解码等。 * ED25519 常用签名函数：这些函数主要用于处理和操作 ED25519 签名算法相关的任务。 * ECDSA 常用签名函数：这些函数主要用于处理和操作椭圆曲线数字签名算法 (ECDSA) 相关的任务。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/crypto ### aptos-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#aptos-sdk) Aptos SDK 主要用集成 Aptos 区块链，包含有私钥生成、私钥派生、生成地址、交易转帐等功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/aptos 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新的地址 | | ValidateAddress | 验证地址的有效性 | | SignRawTransaction | 对交易进行签名 | Aptos 交易支持类型有： "transfer"、"tokenTransfer"、"tokenMint"、"tokenBurn"、"tokenRegister"、"dapp"、"simulate"、"offerNft"、"claimNft"、"offerNft\_simulate"、"claimNft\_simulate" 关于 aptos-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/blob/main/coins/aptos/) 文档。 ### bitcoin-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#bitcoin-sdk) bitcoin-sdk 是一个用于集成 Bitcoin 区块链的 SDK，它支持 Bitcoin 的主网和测试网，并提供了一系列的功能函数，使开发者能够更方便地与 Bitcoin 区块链进行交互。除了 BTC，它还支持 BSV、DOGE、LTC 和 TBTC 等币种。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/bitcoin 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新的地址 | | SignTx | 对交易进行签名 | | GenerateUnsignedPSBTHex | PSBT生成交易 | 关于 bitcoin-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/bitcoin) 文档。 ### cosmos-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#cosmos-sdk) Cosmos SDK 是一个用于集成 Cosmos 架构的区块链的工具包，它提供了一系列的功能函数，包括生成私钥、派生私钥、生成地址和交易转账等。它支持的币种包括： * Atom * Axelar * Cronos * Evmos * Iris * Juno * Kava * Kujira * Osmos * Secret * Sei * Stargaze * Terra 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/cosmos 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | Transfer | 签署交易 | | SignMessage | 签署消息 | 关于 cosmos-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/cosmos) 文档。 ### eos-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#eos-sdk) EOS SDK 是一个用于集成 EOS 区块链的工具包，它提供了一系列的功能函数，包括生成私钥、派生私钥、生成地址和交易序列化等。除了 EOS 外，它还支持 WAX 币种。 这些功能函数使开发者能够更方便地与 EOS 区块链进行交互，包括创建和管理钱包，发送和接收交易，以及查询区块链信息等。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/eos 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | SignTransaction | 签署交易 | 关于 eos-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/eos) 文档。 ### ethereum-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#ethereum-sdk) Ethereum SDK 是一个用于集成 Ethereum 区块链和其他支持 EVM（以太坊虚拟机）的区块链的工具包。它提供了一系列的功能函数，包括生成私钥、派生私钥、生成地址和交易转账等。 这些功能函数使开发者能够更方便地与 Ethereum 区块链进行交互，包括创建和管理钱包，发送和接收交易，以及查询区块链信息等。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/ethereum 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | SignTransaction | 签署交易 | | SignMessage | 签署消息 | 关于 ethereum-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/ethereum) 文档。 ### flow-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#flow-sdk) Flow 区块链是一个新一代的、面向未来的区块链平台，它专为高性能应用和游戏而设计。 Flow SDK 是一个用于集成 Flow 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/flow 支持函数： | 函数名称 | 功能 | | --- | --- | | CreateNewAccountTx | 创建地址 | | SignTx | 签署交易 | Flow 交易支持类型有：Account 和 Transfer 关于 flow-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/flow) 文档。 ### near-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#near-sdk) Near 协议是一个可扩展的区块链平台，它通过使用新颖的共识机制和分片技术，实现了高吞吐量和低延迟的交易处理。Near SDK 使开发者能够更方便地开发和部署在 Near 区块链上的应用。 Near SDK 是一个用于集成 Near 协议的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/near 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAccount | 通过种子获取地址 | | SignTransaction | 签署交易 | 关于 near-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/near) 文档。 ### polkadot-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#polkadot-sdk) Polkadot 是一个多链异构的区块链平台，它允许各种区块链网络以共享的安全模型并行运行，同时还能实现链与链之间的信息和价值的无缝转移。 Polkadot SDK 是一个用于集成 Polkadot 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/polkadot 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过种子获取地址 | | SignTx | 签署交易 | 关于 polkadot-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/polkadot) 文档。 ### solana-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#solana-sdk) Solana 是一个高性能的区块链平台，它通过创新的共识算法和区块产生机制，实现了高吞吐量和低延迟的交易处理。 Solana SDK 是一个用于集成 Solana 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/solana 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | SignTransaction | 签署交易 | 关于 solana-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/solana) 文档。 ### stacks-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#stacks-sdk) Stacks 是一个开源的区块链平台，它允许开发者在 Bitcoin 区块链上构建智能合约和去中心化应用。 Stacks SDK 主要用集成 Stacks 区块链，包含多种用于集成 web3 钱包的功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/stacks 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | Transfer | 签署交易 | 关于 stacks-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/stacks) 文档。 ### starknet-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#starknet-sdk) StarkNet 是一个去中心化的、可扩展的区块链网络，它使用了零知识证明技术来提高交易处理的效率和安全性。 StarkNet SDK 是一个用于集成 StarkNet 区块链的工具包，它提供了一系列的功能函数，使开发者能够更方便地与 StarkNet 区块链进行交互。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/starknet 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | CreateSignedContractTx | 签署交易 | 关于 starknet-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/starknet) 文档。 ### sui-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#sui-sdk) SUI SDK 是一个用于集成 SUI 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/sui 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | SignTransaction | 签署交易 | | SignMessage | 签署消息 | 注意：与 secp256k1 不同的是，ed25519 的私钥派生只支持 hard 模式的派生，详情参见：[https://github.com/satoshilabs/slips/blob/master/slip-0010.md](https://github.com/satoshilabs/slips/blob/master/slip-0010.md) 关于 sui-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/sui) 文档。 ### tron-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#tron-sdk) TRON SDK 是一个用于集成 SUI 区块链的工具包，包含多种用于集成 web3 钱包的功能函数。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/tron 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | SignTransaction | 签署交易 | 关于 tron-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/tron) 文档。 ### zkspace-sdk[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#zkspace-sdk) ZKSpace SDK 主要用集成 ZK 合约，包含多种用于集成 web3 钱包的功能函数，除了 ZKSpace 外，还支持 ZKSync。 通过 `go get` 获取最新版本的包： go get -u github.com/okx/go-wallet-sdk/coins/zkspace 支持函数： | 函数名称 | 功能 | | --- | --- | | NewAddress | 通过私钥获取新地址 | | CreateSignTransferTx | 签署交易 | 交易签名支持 data 类型有：transfer 和 changePubkey 关于 zkspace-sdk 包支持的功能函数和使用案例，更加详细内容可以查看 [github](https://github.com/okx/go-wallet-sdk/tree/main/coins/zkspace) 文档。 测试用例[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B) --------------------------------------------------------------------------------------------------------------------- 在 github 上，每个模块对应的 package 下有一个 `tests` 目录，放有各个币种模块的测试用例，可以通过测试用例了解到更多关于 SDK 中函数的用法。 | 币种 | 测试用例 | | --- | --- | | BTC | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/bitcoin/psbt_tx_test.go) | | ETH | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/ethereum/eth_test.go) | | Cosmos | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/cosmos/atom/atom_test.go) | | Aptos | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/aptos/aptos_test.go) | | EOS | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/eos/tx_test.go) | | Solana | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/solana/sol_test.go) | | Stacks | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/stacks/stack_test.go) | | Starknet | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/starknet/account_test.go) | | Sui | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/sui/sui_test.go) | | Tron | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/tron/tron_test.go) | | Zkspace | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/zkspace/account_test.go) | | Flow | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/flow/account_test.go) | | Near | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/near/transaction_test.go) | | Polkadot | [测试用例](https://github.com/okx/go-wallet-sdk/blob/main/coins/polkadot/polkadot_test.go) | 支持币种[#](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E6%94%AF%E6%8C%81%E5%B8%81%E7%A7%8D) --------------------------------------------------------------------------------------------------------------------- | 币族 | 币种 | 派生路径 | | --- | --- | --- | | BTC | BTC | 常规地址：
m/44'/0'/0/0'/0
隔离见证：
m/49'/0'/0/0'/0
m/84'/0'/0/0'/0
m/86'/0'/0/0'/0 | | BTC | BCH | m/44'/145'/0'/0/0 | | BTC | BSV | m/44'/236'/0'/0/0 | | BTC | LTC | m/44'/2'/0'/0/0 | | BTC | Doge | m/44'/3'/0'/0/0 | | BTC | TBTC | m/44'/0'/0/0'/0 | | BTC | Omni usdt | m/44'/0'/0/0'/0 | | ETH | ETH | m/44'/60'/0'/0/0 | | ETH | Arbitrum One | m/44'/60'/0'/0/0 | | ETH | Arbitrum Nova | m/44'/60'/0'/0/0 | | ETH | Avalanche C | m/44'/60'/0'/0/0 | | ETH | Boba | m/44'/60'/0'/0/0 | | ETH | BNB Chain | m/44'/60'/0'/0/0 | | ETH | Base | m/44'/60'/0'/0/0 | | ETH | Core | m/44'/60'/0'/0/0 | | ETH | Cronos(EVM) | m/44'/60'/0'/0/0 | | ETH | Celo | m/44'/60'/0'/0/0 | | ETH | Conflux(EVM) | m/44'/60'/0'/0/0 | | ETH | Endurance | m/44'/60'/0'/0/0 | | ETH | EthereumPoW | m/44'/60'/0'/0/0 | | ETH | EthereumFair | m/44'/60'/0'/0/0 | | ETH | Filecoin EVM | m/44'/60'/0'/0/0 | | ETH | Fantom | m/44'/60'/0'/0/0 | | ETH | Flare | m/44'/60'/0'/0/0 | | ETH | Gnosis | m/44'/60'/0'/0/0 | | ETH | Goerli | m/44'/60'/0'/0/0 | | ETH | HAQQ Network | m/44'/60'/0'/0/0 | | ETH | Klaytn | m/44'/60'/0'/0/0 | | ETH | KCC | m/44'/60'/0'/0/0 | | ETH | Kava EVM | m/44'/60'/0'/0/0 | | ETH | Linea | m/44'/60'/0'/0/0 | | ETH | Metis | m/44'/60'/0'/0/0 | | ETH | Moonebeam | m/44'/60'/0'/0/0 | | ETH | Moonriver | m/44'/60'/0'/0/0 | | ETH | Mantle | m/44'/60'/0'/0/0 | | ETH | Omega Network | m/44'/60'/0'/0/0 | | ETH | OKTC | m/44'/60'/0'/0/0 | | ETH | Optimism | m/44'/60'/0'/0/0 | | ETH | opBNB | m/44'/60'/0'/0/0 | | ETH | Polygon | m/44'/60'/0'/0/0 | | ETH | Polygon zkEVM | m/44'/60'/0'/0/0 | | ETH | PulseChain | m/44'/60'/0'/0/0 | | ETH | Sepolia | m/44'/60'/0'/0/0 | | ETH | zkSync Era | m/44'/60'/0'/0/0 | | ETH | ZetaChian | m/44'/60'/0'/0/0 | | Cosmos | Atom | m/44'/118'/0'/0/0 | | Cosmos | Axelar | m/44'/118'/0'/0/0 | | Cosmos | Cronos | m/44'/394'/0'/0/0 | | Cosmos | Osmos | m/44'/118'/0'/0/0 | | Cosmos | Evmos | m/44'/60'/0'/0/0 | | Cosmos | Iris | m/44'/118'/0'/0/0 | | Cosmos | Juno | m/44'/118'/0'/0/0 | | Cosmos | Kava | m/44'/459'/0'/0/0 | | Cosmos | Kujira | m/44'/118'/0'/0/0 | | Cosmos | Secret | m/44'/529'/0'/0/0 | | Cosmos | Sei | m/44'/118'/0'/0/0 | | Cosmos | Stargaze | m/44'/118'/0'/0/0 | | Cosmos | Terra | m/44'/330'/0'/0/0 | | Aptos | Aptos | m/44'/637'/0'/0/0 | | EOS | EOS | m/44'/194'/0'/0/0 | | Solana | Solana | m/44'/501'/0'/0/0 | | Stacks | Stacks | m/44'/5757'/0'/0/0 | | ETH layer 2 | Starknet | m/44'/9004'/0'/0/0 | | SUI | SUI | m/44'/784'/0'/0/0 | | TRX | TRON | m/44'/195'/0'/0/0 | | ETH layer 2 | ZKSpace | m/44'/60'/0'/0/0 | | ETH layer 2 | zkSync | m/44'/60'/0'/0/0 | [Javascript 签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-javascript-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) 目录 [概述](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E6%A6%82%E8%BF%B0) [安装和构建](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E5%AE%89%E8%A3%85%E5%92%8C%E6%9E%84%E5%BB%BA) [主要功能](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E4%B8%BB%E8%A6%81%E5%8A%9F%E8%83%BD) [Packages](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#packages) [测试用例](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B) [支持币种](https://web3.okx.com/zh-hans/build/docs/waas/private-key-wallet-go-sdk#%E6%94%AF%E6%8C%81%E5%B8%81%E7%A7%8D) --- # 已经接入的市场 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 已经接入的市场 已经接入的市场[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets#%E5%B7%B2%E7%BB%8F%E6%8E%A5%E5%85%A5%E7%9A%84%E5%B8%82%E5%9C%BA) ======================================================================================================================================================== | 市场 | 关键词 | 支持上架的网络 | 支持获取订单的网络 | | --- | --- | --- | --- | | OKX | okx | 详情见[已接入网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | 详情见[已接入网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | opensea.io | opensea | eth, polygon, avax, arbitrum, arbitrum-nova, optimism, klaytn, base | eth, polygon, avax, arbitrum, arbitrum-nova, optimism, klaytn, base | | looksrare.org | looksrare | \- | eth | | element.market | element | \- | eth, polygon, bnb, zksync-era, arbitrum, avax | | x2y2.io | x2y2 | \- | eth | [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) --- # 删除账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) 删除账户 删除账户[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account#%E5%88%A0%E9%99%A4%E8%B4%A6%E6%88%B7) ======================================================================================================================== 删除已创建的账户。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/account/delete-account` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | accountId | String | Yes | 账户的唯一标识 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 无 [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/account/delete-account' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "accountId": "13886e05-1265-4b79-8ac3-b7ab46217655", }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [], "msg": "success" } [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) --- # 搭建链上数据看板 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) [搭建链上数据看板](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) [搭建铭文钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) [搭建 Web3 钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) 搭建链上数据看板 搭建链上数据看板[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%90%AD%E5%BB%BA%E9%93%BE%E4%B8%8A%E6%95%B0%E6%8D%AE%E7%9C%8B%E6%9D%BF) ================================================================================================================================================================== 请确保已完成了[准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) ，可直接通过此案例，熟悉链上数据查询的各类方式。 方式一：按地址查询[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%96%B9%E5%BC%8F%E4%B8%80%EF%BC%9A%E6%8C%89%E5%9C%B0%E5%9D%80%E6%9F%A5%E8%AF%A2) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### 查询资产[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%9F%A5%E8%AF%A2%E8%B5%84%E4%BA%A7) 调用接口来获取集成 60 +链的，多链多协议[资产数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) ，秒级更新。 ### 查询币价及币种信息[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%9F%A5%E8%AF%A2%E5%B8%81%E4%BB%B7%E5%8F%8A%E5%B8%81%E7%A7%8D%E4%BF%A1%E6%81%AF) 调用接口来获取集成各大交易所、DEX 及市场的多数据源的[币价数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) 。 ### 查询持有的 UTXO 及铭文[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%9F%A5%E8%AF%A2%E6%8C%81%E6%9C%89%E7%9A%84-utxo-%E5%8F%8A%E9%93%AD%E6%96%87) 调用接口来获取[持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) 及[铭文详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) 。 ### 查询交易历史[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%9F%A5%E8%AF%A2%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2) 调用接口来获取各个链上地址生成以来的[全量交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) 数据 ### 查询授权[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%9F%A5%E8%AF%A2%E6%8E%88%E6%9D%83) 调用接口来查看地址上的[授权详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) 方式二：按账户批量查询[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%96%B9%E5%BC%8F%E4%BA%8C%EF%BC%9A%E6%8C%89%E8%B4%A6%E6%88%B7%E6%89%B9%E9%87%8F%E6%9F%A5%E8%AF%A2) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ### 第一步：创建账户[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E7%AC%AC%E4%B8%80%E6%AD%A5%EF%BC%9A%E5%88%9B%E5%BB%BA%E8%B4%A6%E6%88%B7) 创建钱包账户 ([AccountId](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#accountid) )，来聚合你想查看的地址，进行批量查询代币余额和交易历史。 具体实现：调用接口来[创建钱包账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) 。 例如，同时订阅不同链上的同一地址，实现如下： //定义你的参数 const addresses = [\ {\ "chainIndex":"1",\ "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db",\ },\ {\ "chainIndex":"10",\ "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db",\ }\ ]; const getCreateWalletAccountBody = { addresses: addresses }; //定义辅助函数 const getCreateWalletAccountData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/account/create-wallet-account' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(getCreateWalletBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: createWalletAccountData } = await getCreateWlletAccountData(); * * * ### 第二步：查询余额[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E7%AC%AC%E4%BA%8C%E6%AD%A5%EF%BC%9A%E6%9F%A5%E8%AF%A2%E4%BD%99%E9%A2%9D) 钱包账户可直接调用接口查看账户下所持有的币种，[点击查钱包账户代币余额](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) 查看详情。 //定义参数 const getAssetsParams = { accountId: '13886e05-1265-4b79-8ac3-b7ab46211001', }; //定义辅助函数 const getAssetsData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/asset/wallet-all-token-balances', getAssetsParams ); return fetch(apiRequestUrl, { method: 'GET', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: getAssetsData } = await getAssetsData(); 当查询到资产时，你将收到如下的响应： { "code": "0", "data": [\ {\ "chainIndex": "1",\ "tokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",\ "symbol": "USDT",\ "balance": "0.688467",\ "tokenPrice": "0.99993",\ "tokenType": "1"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x514910771af9ca656af840dff83e8264ecf986ca",\ "symbol": "LINK",\ "balance": "0.000000366257612925",\ "tokenPrice": "14.108071299717093",\ "tokenType": "1"\ }\ ], "msg": "success" } * * * ### 第三步：查询交易历史[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9F%A5%E8%AF%A2%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2) 发送交易后，使用 `GET /api/v5/wallet/post-transaction/transaction-detail-by-txhash` 接口并提供 `txHash` 以获取交易详情。 // 定义你的参数 const params = { txhash: '0x9ab8ccccc9f778ea91ce4c0f15517672c4bd06d166e830da41ba552e744d29a5', chainIndex: '42161' }; // 定义辅助函数 const getTransactionDetailData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/post-transaction/transaction-detail-by-txhash', params ); return fetch(apiRequestUrl, { method: 'get', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: transactionDetailData } = await getTransactionDetailData(); 在查询交易历史时，你将收到下列响应： { "code": "0", "msg": "success", "data": [\ {\ "chainIndex": "42161",\ "height": "245222398",\ "txTime": "1724253417000",\ "txhash": "0x9ab8ccccc9f778ea91ce4c0f15517672c4bd06d166e830da41ba552e744d29a5",\ "gasLimit": "2000000",\ "gasUsed": "2000000",\ "gasPrice": "10000000",\ "nonce": "0",\ "symbol": "ETH",\ "amount": "0",\ "txStatus": "success",\ "methodId": "0xc9f95d32",\ "l1OriginHash": "0xa6a87ba2f18cc32bbae8f3b2253a29a9617ed1eb0940d80443f6e3bf9873dbad",\ "fromDetails": [\ {\ "address": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "vinIndex": "",\ "preVoutIndex": "",\ "txHash": "",\ "isContract": false,\ "amount": ""\ }\ ],\ "toDetails": [\ {\ "address": "0x000000000000000000000000000000000000006e",\ "voutIndex": "",\ "isContract": false,\ "amount": ""\ }\ ],\ "internalTransactionDetails": [\ {\ "from": "0x0000000000000000000000000000000000000000",\ "to": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "isFromContract": false,\ "isToContract": false,\ "amount": "0.02",\ "state": "success"\ },\ {\ "from": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "to": "0x428ab2ba90eba0a4be7af34c9ac451ab061ac010",\ "isFromContract": false,\ "isToContract": false,\ "amount": "0.00998",\ "state": "success"\ },\ {\ "from": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "to": "0x428ab2ba90eba0a4be7af34c9ac451ab061ac010",\ "isFromContract": false,\ "isToContract": false,\ "amount": "0.009977946366846017",\ "state": "success"\ }\ ],\ "tokenTransferDetails": []\ }\ ] } 到这里，你基本上已经实现了开发一款链上数据看板所需的基础功能。 此外，钱包 API 提供了丰富接口，全方位满足交易所钱包开发者的需求，具体请查看下面的章节，了解更多。 [准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) [搭建铭文钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) 目录 [方式一：按地址查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%96%B9%E5%BC%8F%E4%B8%80%EF%BC%9A%E6%8C%89%E5%9C%B0%E5%9D%80%E6%9F%A5%E8%AF%A2) [方式二：按账户批量查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard#%E6%96%B9%E5%BC%8F%E4%BA%8C%EF%BC%9A%E6%8C%89%E8%B4%A6%E6%88%B7%E6%89%B9%E9%87%8F%E6%9F%A5%E8%AF%A2) --- # 搭建铭文钱包 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) [搭建链上数据看板](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) [搭建铭文钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) [搭建 Web3 钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) 搭建铭文钱包 搭建铭文钱包[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E6%90%AD%E5%BB%BA%E9%93%AD%E6%96%87%E9%92%B1%E5%8C%85) ================================================================================================================================================ 钱包 API 已支持主流 BRC-20、Runes、ARC-20 和 SRC-20 、Ordinals\_NFT 五种热门的铭文资产。 请确保已完成了[准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) ，接着可直接通过此案例，熟悉铭文数据的查询、铭文交易的构建和广播。 第一步：生成钱包助记词及地址[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%B8%80%E6%AD%A5%EF%BC%9A%E7%94%9F%E6%88%90%E9%92%B1%E5%8C%85%E5%8A%A9%E8%AE%B0%E8%AF%8D%E5%8F%8A%E5%9C%B0%E5%9D%80) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 你可以使用我们提供的 [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) 创建钱包助记词及地址。 ### npm install[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#npm-install) 首先需要安装到最新的签名 SDK 版本，以 BTC 网络为例： npm install @okxweb3/crypto-lib npm install @okxweb3/coin-base npm install @okxweb3/coin-bitcoin ### 本地构建[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E6%9C%AC%E5%9C%B0%E6%9E%84%E5%BB%BA) 1. 下载项目源码 git clone https://github.com/okx/js-wallet-sdk.git 2. 运行构建脚本 sh build.sh 以 BTC 网络为例，可以依照下述代码，使用签名 SDK 创建一个 BTC 钱包对象，并且推导出所对应地址。 import { BtcWallet,MessageTypes} from "@okxweb3/coin-bitcoin"; // btc wallet let wallet = new BtcWallet() // get mnemonic let mnemonic = await getMnemonic(128); let param = { mnemonic: mnemonic, hdPath: "m/44'/0'/0'/0/0" }; // get derived key let privateKey = await wallet.getDerivedPrivateKey(param); // get new address import { BtcWallet } from "@okxweb3/coin-bitcoin"; let wallet = new BtcWallet() // legacy address let params: NewAddressParams = { privateKey: "L22jGDH5pKE4WHb2m9r2MdiWTtGarDhTYRqMrntsjD5uCq5z9ahY" }; let address = await wallet.getNewAddress(params); // native segwit address let params2: NewAddressParams = { privateKey: "L22jGDH5pKE4WHb2m9r2MdiWTtGarDhTYRqMrntsjD5uCq5z9ahY", addressType: "segwit_native", }; let address2 = await wallet.getNewAddress(params2); // nested segwit address let params3: NewAddressParams = { privateKey: "L22jGDH5pKE4WHb2m9r2MdiWTtGarDhTYRqMrntsjD5uCq5z9ahY", addressType: "segwit_nested", }; let address3 = await wallet.getNewAddress(params3); // taproot segwit address let params4: NewAddressParams = { privateKey: "L22jGDH5pKE4WHb2m9r2MdiWTtGarDhTYRqMrntsjD5uCq5z9ahY", addressType: "segwit_taproot", }; let address4 = await wallet.getNewAddress(params4); // get the public key let publicKey = newAddress.publicKey; console.log("the corresponding public key:", publicKey); ### 演示程序[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E6%BC%94%E7%A4%BA%E7%A8%8B%E5%BA%8F) 我们准备了一个[开源演示程序](https://okx.github.io/js-wallet-sdk-demo/) ，用于展示我们上述涉及到签名 SDK 的功能。 获取演示程序源码[点击这里](https://github.com/okx/js-wallet-sdk-demo) 。 * * * 第二步：创建账户[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%BA%8C%E6%AD%A5%EF%BC%9A%E5%88%9B%E5%BB%BA%E8%B4%A6%E6%88%B7) -------------------------------------------------------------------------------------------------------------------------------------------------------------------- 你在上一步，已经生成了助记词和地址。现在你可以创建账户 [(AccountId)](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) 来聚合多个地址，进行批量查询代币余额和交易历史。 说明 通常情况，Web3 钱包有三个概念： \- 钱包，谁拥有助记词，谁就拥有钱包。 \- 账户，基于 BIP-44 规范，一套助记词下可以派生多个账户。 \- 地址，每个账户下的每个链，对应一个地址。 调用接口来[创建钱包账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) 。 例如，创建一个支持不同地址类型的 BTC 钱包账户： //定义你的参数 const addresses = [\ {\ "chainIndex":"0",\ "address":"bc1peqgjr3cwl09mmsh6kvjsvv3ffu4waha00x7xrqrt85wt3zgdwphs72ctnu",\ },\ {\ "chainIndex":"0",\ "address":"18u8nvU5rx1drgwiT4M9sGTD9JX8r53KM9",\ }\ ]; const getCreateAccountBody = { addresses: addresses, signMessage: '1717062864123', // UNIX Timestamp in millisecond }; //定义辅助函数 const getCreateAccountData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/account/create-wallet-account' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(getCreateAccountBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: createAccountData } = await getCreateAccountData(); * * * 第三步：构建并发送铭文交易[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E9%80%81%E9%93%AD%E6%96%87%E4%BA%A4%E6%98%93) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### 获取签名所需信息[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E8%8E%B7%E5%8F%96%E7%AD%BE%E5%90%8D%E6%89%80%E9%9C%80%E4%BF%A1%E6%81%AF) 首先，调用 `POST /api/v5/wallet/pre-transaction/sign-info` 接口，查询签名所需要的一些数据，例如 BTC 链的费率、铭文大小输出等。 //定义你的参数 // BTC const postSignInfoBody = { chainIndex: '0', fromAddr: 'bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u', toAddr: 'bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u', txAmount: '0', extJson: { } }; //定义辅助函数 const signInfoData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/pre-transaction/sign-info' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(postSignInfoBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: signInfoData } = await signInfoData(); 当查询到相关信息后，你将收到如下的响应： { "code": "0", "msg": "success", "data": [\ {\ "normalFeeRate": "5",\ "maxFeeRate": "5",\ "minFeeRate": "5",\ "inscriptionOutput": "546",\ "minOutput": "546",\ "normalCost": "1800",\ "maxCost": "3600",\ "minCost": "600"\ }\ ] } ### 获取全量 UTXO[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E8%8E%B7%E5%8F%96%E5%85%A8%E9%87%8F-utxo) 调用 `GET /api/v5/wallet/utxo/utxo` 接口，查询当前地址下所有可用的 UTXO //定义你的参数 // BTC const postSignInfoBody = { chainIndex: '0', fromAddr: 'bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u', toAddr: 'bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u', txAmount: '0', extJson: { } }; //定义辅助函数 const signInfoData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/pre-transaction/sign-info' ); return fetch(apiRequestUrl, { method: 'get', headers: headersParams, body: JSON.stringify(postSignInfoBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: signInfoData } = await signInfoData(); ### 获取 UTXO 上铭文资产详情[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E8%8E%B7%E5%8F%96-utxo-%E4%B8%8A%E9%93%AD%E6%96%87%E8%B5%84%E4%BA%A7%E8%AF%A6%E6%83%85) 调用 `POST /api/v5/wallet/utxo/utxo-detail` 接口，查询 UTXO 上的铭文详情。 //定义你的参数 // BTC const postSignInfoBody = { chainIndex: '0', fromAddr: 'bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u', toAddr: 'bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u', txAmount: '0', extJson: { } }; //定义辅助函数 const signInfoData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/pre-transaction/sign-info' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(postSignInfoBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: signInfoData } = await signInfoData(); ### 验证地址构建交易[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E9%AA%8C%E8%AF%81%E5%9C%B0%E5%9D%80%E6%9E%84%E5%BB%BA%E4%BA%A4%E6%98%93) 使用签名 SDK 先验证地址合法性再构建交易 // Verify address let valid = await wallet.validAddress({ address: newAddress.address }); console.log("verify address isValid:", valid.isValid); // Sign a transaction let signParams = { privateKey: derivePrivateKey, data: { to: newAddress.address, value: new BigNumber(0), nonce: 5, gasPrice: new BigNumber(100 * 1000000000), gasLimit: new BigNumber(21000), chainId: 42 } }; let signedTx = await wallet.signTransaction(signParams); console.log("signed tx:", signedTx); ### 广播交易[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E5%B9%BF%E6%92%AD%E4%BA%A4%E6%98%93) 调用[接口](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) ，交易广播到链上。 //定义你的参数 const postSendTransactionBody = { signedTx: "02000000000101a92808fb32063058e3c752ad2c4a0a6f8957e858dd01483ccff504d4f5ca791d0500000000fdffffff02c405000000000000225120728b5d2f0cf833264adac833e997931155b4aec3020bc87c32fa91509bb2abe61f71080000000000225120f0513064fe1e5b5c31bedff43b943f2f1211d14ab2891687241b138d214888e30140393a287212d5c7341a5d44ba2409dda5db95a854e500475ec8bf2ea0f7f63d35c849102c0f906f48d1833f3b5b7a7ca726e14fc2d715b4cbbecb8488e028baab00000000" accountId:"c79e7775-9e78-4a2d-b27f-9021f3bf5fca", address: "bc1p7pgnqe87red4cvd7ml6rh9pl9ufpr522k2y3dpeyrvfc6g2g3r3s3ae9dr", }; //定义辅助函数 const sendTransactionData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, 'api/v5/wallet/pre-transaction/broadcast-transaction' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(postSendTransactionBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: sendTransactionData } = await sendTransactionData(); 广播后，你将收到如下的响应： { "code": 0, "msg": "success", "data": [{\ "orderId": "469356614923743232"\ }] } 说明 点击查看 [orderId](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#orderid) 的定义 * * * 第五步：查询铭文交易详情[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%BA%94%E6%AD%A5%EF%BC%9A%E6%9F%A5%E8%AF%A2%E9%93%AD%E6%96%87%E4%BA%A4%E6%98%93%E8%AF%A6%E6%83%85) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ 当发送交易后，使用 `GET /api/v5/wallet/post-transaction/inscription-transaction-detail-by-txhash` 接口并通过 txhash 来获取铭文交易详情信息。 //定义你的参数 const params = { accountId: '13886e05-1265-4b79-8ac3-b7ab46211001', orderId: '469356614923743232', chainIndex: '1' }; //定义辅助函数 const getTransactionDetailData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/post-transaction/transaction-detail-by-ordid', params ); return fetch(apiRequestUrl, { method: 'get', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: transactionDetailData } = await getTransactionDetailData(); 查询详情成功后，你将收到如下的响应： { "code": 0, "msg": "success", "data": [\ {\ "chainIndex": "1",\ "orderId": "469356614923743232",\ "txhash": "0xcbf411766d65f3cf92839ababa73c4afec69a83442e8b67a68b5104b50a04ejb",\ "blockHash" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",\ "blockHeight" : "19235519",\ "blockTime" : "1708026551000",\ "feeUsdValue" : "138.846919",\ "fees" : "49102595635945621",\ "gasLimit" : "2000000",\ "gasPrice" : "87504603347",\ "gasUsed" : "561143",\ "txType": "0", \ "txTime": "0", \ "txStatus": "0",\ "txDetail": [\ {\ "iType" : "0", \ "txAmount": "0",\ "tokenAddress":""\ "contractCall" : true,\ "fromAddr" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",\ "toAddr" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",\ "logIndex" : "-1",\ "status" : "SUCCESS"\ }\ ]\ }\ ] } 此外，你还可以通过订阅 Webhook，实时准确地了解交易发送后的状态，[查看详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-webhook-intro) 。 * * * 到这里，你基本上已经实现了开发一款铭文钱包所需的部分基础功能。 此外，钱包 API 提供了丰富接口，全方位满足 Web3 钱包开发者的需求，具体请查看下方其他章节。 [搭建链上数据看板](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) [搭建 Web3 钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) 目录 [第一步：生成钱包助记词及地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%B8%80%E6%AD%A5%EF%BC%9A%E7%94%9F%E6%88%90%E9%92%B1%E5%8C%85%E5%8A%A9%E8%AE%B0%E8%AF%8D%E5%8F%8A%E5%9C%B0%E5%9D%80) [第二步：创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%BA%8C%E6%AD%A5%EF%BC%9A%E5%88%9B%E5%BB%BA%E8%B4%A6%E6%88%B7) [第三步：构建并发送铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E9%80%81%E9%93%AD%E6%96%87%E4%BA%A4%E6%98%93) [第五步：查询铭文交易详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription#%E7%AC%AC%E4%BA%94%E6%AD%A5%EF%BC%9A%E6%9F%A5%E8%AF%A2%E9%93%AD%E6%96%87%E4%BA%A4%E6%98%93%E8%AF%A6%E6%83%85) --- # 错误码 | 资源 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) [常用参数定义](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) [查看 chainIndex](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-errorcode) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) 错误码 错误码[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-errorcode#%E9%94%99%E8%AF%AF%E7%A0%81) =============================================================================================================== 钱包 API 当前返回的错误码及内容如下，可查看列表了解详情。 | 错误码 | http状态码 | 提示信息 | | --- | --- | --- | | 50001 | 200 | 服务临时不可用，稍后重试 | | 50026 | 500 | 系统繁忙，稍后重试 | | 81104 | 200 | 不支持该区块链 | | 81105 | 200 | 钱包校验错误 | | 81106 | 200 | 地址必须为小写 | | 81107 | 200 | 钱包地址过多 | | 81108 | 200 | 钱包类型不匹配 | | 81109 | 200 | 地址更新错误 | | 81150 | 200 | 接口不支持该链 | | 81151 | 200 | 代币地址不正确 | | 81152 | 200 | 代币不存在 | | 81153 | 200 | 该代币是平台代币，无需添加 | | 81157 | 200 | 区块链与地址不匹配 | | 81158 | 200 | 不支持的代币协议 | | 81159 | 200 | 数据缓存中，请稍后再试 | | 81201 | 200 | 交易未找到 | | 81202 | 200 | 交易仍在等待确认 | | 81203 | 200 | 交易extjson参数未找到 | | 81302 | 200 | FromAddress不属于该账户ID | | 81351 | 200 | 余额不足，无法支付 | | 81353 | 200 | 地址不合法 | | 81451 | 200 | 节点返回失败 | [查看 chainIndex](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) --- # 查广播订单列表 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) 查广播订单列表 查广播订单列表[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list#%E6%9F%A5%E5%B9%BF%E6%92%AD%E8%AE%A2%E5%8D%95%E5%88%97%E8%A1%A8) ================================================================================================================================================================= 查询账户下，从钱包 API 广播接口发出的订单列表，支持查询 EVM 和 UTXO 模型网络的交易，按时间倒序排列。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/post-transaction/orders` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | address | String | No | 查地址下列表，地址或账户 ID 需要必填一项，如果都传，以账户 ID 为准。 | | accountId | String | No | 查账户下列表，地址或账户 ID 需要必填一项 | | chainIndex | String | No | 链唯一标识 | | txStatus | String | No | 交易状态:
`1`: 排队中
`2`: 成功
`3`:失败 | | orderId | String | No | 交易订单唯一标识 | | cursor | String | No | 游标 | | limit | String | No | 返回条数，默认返回最近的 20 条，最多 100 条 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | chainIndex | String | 链唯一标识 | | address | String | 地址 | | accountId | String | 账户唯一标识符 | | orderId | String | 订单 Id | | txStatus | String | 交易状态:
`1`: 排队中
`2`: 成功
`3`:失败 | | txHash | String | 交易哈希 | | limit | String | 返回条数，默认返回最近的 20 条，最多 100 条 | [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/post-transaction/orders?accountId=c79e7775-9e78-4a2d-b27f-9021f3bf5fca' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "chainIndex": "1",\ "accountId": "c79e7775-9e78-4a2d-b27f-9021f3bf5fca",\ "orderId": "016cf21d020be6c2f071dad9bbd8ec5cb9342fa8",\ "address": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",\ "txHash": "0xb240e65dd9156b4a450be72f6c9fe41be6f72397025bb465b21a96ee9871a589",\ "txstatus": "2"\ },\ {\ "chainIndex": "1",\ "accountId": "c79e7775-9e78-4a2d-b27f-9021f3bf5fca",\ "orderId": "592051a92a744627022955be929ecb5c9e777705",\ "address": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",\ "txHash": "0xc401ffcd2a2b4b1db42ce68dfde8e63c0a1e9653484efb2873dbf5d0cbeb227a",\ "txstatus": "1"\ }\ ] } [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) * * * --- # 已部署合约 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 已部署合约 已部署合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract#%E5%B7%B2%E9%83%A8%E7%BD%B2%E5%90%88%E7%BA%A6) =================================================================================================================================== 聚合器合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract#%E8%81%9A%E5%90%88%E5%99%A8%E5%90%88%E7%BA%A6) ----------------------------------------------------------------------------------------------------------------------------------- | **编号** | **网络** | **合约地址** | | --- | --- | --- | | 1 | Ethereum | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 2 | OKTC | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 3 | BNB Chain | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 4 | Polygon | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 5 | Avalanche-C | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 6 | Arbitrum One | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 7 | Arbitrum Nova | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 8 | zkSync Era | 0x444b2Fd4395Ec890fbC492753DCe1bE2fC8Ff63D | | 9 | Optimism | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 10 | Klaytn | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 11 | Base | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 12 | Linea | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 13 | opBNB | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | | 14 | Polygon zkEVM | 0xa7FD99748cE527eAdC0bDAc60cba8a4eF4090f7c | 欧易自营市场合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract#%E6%AC%A7%E6%98%93%E8%87%AA%E8%90%A5%E5%B8%82%E5%9C%BA%E5%90%88%E7%BA%A6) ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | **编号** | **网络** | **合约地址** | | --- | --- | --- | | 1 | Ethereum | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 2 | OKTC | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 3 | BNB Chain | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 4 | Polygon | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 5 | Avalanche-C | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 6 | Arbitrum One | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 7 | Arbitrum Nova | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 8 | zkSync Era | 0xd756E8070b33a35E42f00140Ac92c4b4e0bBfb82 | | 9 | Optimism | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 10 | Klaytn | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 11 | Base | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 12 | Linea | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 13 | opBNB | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | | 14 | Polygon zkEVM | 0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC | [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) 目录 [聚合器合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract#%E8%81%9A%E5%90%88%E5%99%A8%E5%90%88%E7%BA%A6) [欧易自营市场合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract#%E6%AC%A7%E6%98%93%E8%87%AA%E8%90%A5%E5%B8%82%E5%9C%BA%E5%90%88%E7%BA%A6) --- # 查询账户 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) 查询账户 查询账户[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts#%E6%9F%A5%E8%AF%A2%E8%B4%A6%E6%88%B7) ================================================================================================================== 列举项目下创建过的账户。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/account/accounts` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | limit | String | No | 每次查询多少条,默认值为 50，最大100 | | cursor | String | No | 游标位置，默认为第一个 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | cursor | String | 游标 | | accounts | Array | 账户列表 | | \>accountId | String | 账户唯一标识 | | \>accountType | String | 账户类型:
`0`: 钱包账户
`1`:观察账户 | [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/account/accounts' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "cursor": "50",\ "accounts": [\ {\ "accountId": "0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2",\ "accountType": "0"\ },\ { \ "accountId": "0x04ad62387d1f1c7034087bbe4d16163d06fae42d",\ "accountType": "1"\ }\ ]\ }\ ], "msg": "success" } [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) --- # 查询账户下的地址 | 钱包账户管理 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) [更新账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-update-wallet-account) [删除账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-delete-account) [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [查询账户下的地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) 查询账户下的地址 查询账户下的地址[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail#%E6%9F%A5%E8%AF%A2%E8%B4%A6%E6%88%B7%E4%B8%8B%E7%9A%84%E5%9C%B0%E5%9D%80) ================================================================================================================================================================ 查询某个账户下绑定的地址。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/account/account-detail` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | accountId | String | Yes | 账户的唯一标识 | | chainIndex | String | No | 链的唯一标识 | | limit | String | No | 每次查询多少条,默认值为 50，最大100 | | cursor | String | No | 游标位置，默认为第一个 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | cursor | String | 游标 | | addresses | Array | 地址列表 | | \>chainIndex | String | 链唯一标识 | | \>address | String | 地址 | | \>remark | String | 地址备注 | [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/account/account-detail?accountId=44486e05-3235-2f8e-5fe2-a8ab46217863' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-account-detail#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ { \ "cursur": "50",\ "addresses": [\ {\ "chainIndex": "1",\ "address":"0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2"\ },\ {\ "chainIndex": "3",\ "address":"0x04ad62387d1f1c7034087bbe4d16163d06fae42d"\ }\ ]\ }\ ]， "msg": "success" } [查询账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-accounts) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) --- # 获取 Fractal Ordinals 合集列表 | Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [获取 Fractal Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Fractal Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) 获取 Fractal Ordinals 合集列表 获取 Fractal Ordinals 合集列表[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list#%E8%8E%B7%E5%8F%96-fractal-ordinals-%E5%90%88%E9%9B%86%E5%88%97%E8%A1%A8) ======================================================================================================================================================================================================== 该接口用于获取全部 Fractal NFT 和 Brc20 合集的列表 ，包括合集唯一标识 slug、铭文编号范围、交易额以及地板价。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/collections` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 否 | 合集 slug 名称，即合集的唯一标识，参数不为空则代表查询指定合集 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 100，最大 300）。返回最大的合集数 | | isBrc20 | Boolean | 否 | 获取全部 Fractal NFT 或 Brc20 合集的列表，默认为 Brc20 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个 [Ordinals 合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model.html#ordinals%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | slug | String | 合集 slug 名称，即合集的唯一标识 | | totalVolume | String | 合集总交易额，FB 计价 | | floorPrice | String | 合集地板价，FB 计价 | | inscriptionNumRange | String | 合集铭文编号范围 | | volume24h | String | 合集24小时交易额，FB 计价 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT | [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/collections" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "limit=1" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "", "data": [\ {\ "floorPrice": "0.84",\ "inscriptionNumRange": "#398426-#3488986",\ "isBrc20": false,\ "slug": "fractal-pepe-1",\ "totalVolume": "6.927321832273747",\ "volume24h": "0.026769803732172824"\ }\ ] }, "msg": "" } [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) --- # 获取合集信息 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Runes API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) 获取合集信息 获取合集信息[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection#%E8%8E%B7%E5%8F%96%E5%90%88%E9%9B%86%E4%BF%A1%E6%81%AF) ================================================================================================================================================ 该接口用于获取符文信息：包括持有人数、合集链接、交易额、交易笔数和地板价。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/runes/detail` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **是否必传** | **参数说明** | | --- | --- | --- | --- | | runesId | String | Yes | runesId，支持批量查询，使用‘,’分隔，例如 840000:3, 840000:28 | ### 返回参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection#%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0) | **参数** | **类型** | **参数说明** | | --- | --- | --- | | rune | String | 符文名称 | | spacename | String | 加点后的符文名称 | | maxMintNumber | String | 最多 mint 数量 | | mintedNumber | String | 已铸造数量 | | limitPerMint | String | 单笔 mint 上限 | | deployedTime | Long | 部署时间 | | startBlock | String | 起始区块 | | endBlock | String | 结束区块 | | symbol | String | 符号 | | divisibility | Integer | 精度 | | collectionUrl | String | OKX 合集链接 | | totalVolume | String | 总交易额，BTC 计价 | | usdTotalVolume | String | 总交易额，USD 计价 | | marketCap | String | 市值，BTC 计价 | | usdMarketCap | String | 市值，USD 计价 | | floorprice | String | 地板价，Sats 计价 | | usdFloorPrice | String | 地板价，USD 计价 | | holders | Integer | 持有地址数 | | salesCount | Integer | 成交数量 | [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/mktplace/nft/runes/detail?runesId=840000%3A3%2C840000%3A28' \ --header 'OK-ACCESS-PASSPHRASE: xxx' \ --header 'OK-ACCESS-KEY: xxx' \ ### 返回示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection#%E8%BF%94%E5%9B%9E%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": [\ {\ "collectionUrl": "https://web3.okx.com/web3/marketplace/runes/token/DOG•GO•TO•THE•MOON/840000:3",\ "deployedTime": 1713571767,\ "divisibility": 5,\ "marketData": {\ "floorPrice": "10.6509577683",\ "holders": 72903,\ "marketCap": "10651.030343051788712385",\ "salesCount": 35436,\ "totalVolume": "1124.64783456999999",\ "usdFloorPrice": "0.006598097922137557",\ "usdMarketCap": "659814288.103509427870310934",\ "usdTotalVolume": "69670133.915076187380516"\ },\ "maxMintNumber": "100000000000",\ "mintedNumber": "100000000000",\ "name": "DOG•GO•TO•THE•MOON",\ "runesId": "840000:3",\ "spaceName": "DOGGOTOTHEMOON",\ "startBlock": 840000,\ "symbol": "🐕"\ }\ ], "msg": "" } [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) --- # 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) 币价及币种信息 币价和项目信息[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata#%E5%B8%81%E4%BB%B7%E5%92%8C%E9%A1%B9%E7%9B%AE%E4%BF%A1%E6%81%AF) ======================================================================================================================================================= 币价和项目信息板块，支持查询币种、币价、币种流通量、供应量和项目官网等信息。 链的支持范围不被 [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) 限制。 [实时币价\ \ 提供多个币种的实时价格信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [历史币价\ \ 提供某个币种的历史价格信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [项目信息\ \ 提供某个币种的详细项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) --- # 错误码 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) 错误码 错误码[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code#%E9%94%99%E8%AF%AF%E7%A0%81) ============================================================================================================ | 错误码 | HTTP 状态 | 提示信息 | | --- | --- | --- | | 0 | 200 | 操作成功 | | 50011 | 429 | 用户请求频率过快，超过该接口允许的限额。请参考 API 文档并限制请求 | | 50014 | 400 | 必填参数 {param0} 不能为空 | | 50026 | 500 | 系统错误，请稍后重试 | | 50103 | 401 | 请求头“OK\_ACCESS\_KEY“不能为空 | | 50104 | 401 | 请求头“OK\_ACCESS\_PASSPHRASE“不能为空 | | 50105 | 401 | 请求头“OK\_ACCESS\_PASSPHRASE“错误 | | 50106 | 401 | 请求头“OK\_ACCESS\_SIGN“不能为空 | | 50107 | 401 | 请求头“OK\_ACCESS\_TIMESTAMP“不能为空 | | 50111 | 401 | 无效的 OK\_ACCESS\_KEY | | 50112 | 401 | 无效的 OK\_ACCESS\_TIMESTAMP | | 50113 | 401 | 无效的签名 | | 51000 | 400 | {param0} 参数错误 | | 80000 | 200 | 重复提交 | | 82000 | 200 | 流动性不足 | | 82001 | 500 | 分佣服务暂不可用 | | 82102 | 200 | 最小数量是 {0} | | 82103 | 200 | 最大数量是 {0} | | 82104 | 200 | 不支持该币种 | | 82105 | 200 | 不支持该链 | [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) --- # 限价单 | 介绍 | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-process) [跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-swap-process) [限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-process) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) 限价单 限价单[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-process#%E9%99%90%E4%BB%B7%E5%8D%95) ========================================================================================================= DEX 限价单 (Limit Order) 是一种用户以指定目标价格在去中心化交易所中买入或卖出代币的业务流程。如果当前市价能够满足用户指定的目标价格，DEX 聚合器会将订单自动完成交易。通过 DEX 限价单 API，用户可以通过接口创建和查询限价单并将流动性聚合入 DEX 聚合器中，享有欧易 DEX 的最优价格。 DEX 限价单 API 功能具有以下特点： * 限价单成交需要等待 DEX 聚合器用户吃单 * 限价单创建者无滑点 * 支持部分订单成交 | 欧易 DEX 限价单 API 交易流程 | | --- | | | [跨链](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-swap-process) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) --- # 介绍 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) 介绍 介绍[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction#%E4%BB%8B%E7%BB%8D) ======================================================================================================= 欢迎浏览欧易 Web3 DeFi API 开发者指南。我们的 API 提供了一系列专为 DeFi 场景打造的数据接口服务，旨在为 DeFi 开发者提供低门槛的项目创建体验。 支持的网络[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction#%E6%94%AF%E6%8C%81%E7%9A%84%E7%BD%91%E7%BB%9C) ------------------------------------------------------------------------------------------------------------------------------------- chainId：是由欧易 Web3 DeFi 自定义的唯一标识，少部分会与 eip155 的 chainId 有差异。 realChainId：eip155 中指定的 chainId。 | 区块链网络 | chainId | realChainId | 支持情况 | | --- | --- | --- | --- | | Bitcoin Mainnet | 0 | | 已经支持 | | Ethereum Mainnet | 1 | 1 | 已经支持 | | OP Mainnet | 10 | 10 | 已经支持 | | BNB Smart Chain Mainnet | 56 | | 已经支持 | | OKT Chain | 66 | 66 | 已经支持 | | Gnosis | 100 | 100 | 已经支持 | | Polygon Mainnet | 137 | 137 | 已经支持 | | Manta Pacific Mainnet | 169 | 169 | 已经支持 | | opBNB Mainnet | 204 | 204 | 已经支持 | | Fantom Opera | 250 | 250 | 已经支持 | | zkSync Era Mainnet | 324 | 324 | 已经支持 | | Polygon zkEVM | 1101 | 1101 | 已经支持 | | Core Blockchain Mainnet | 1116 | 1116 | 已经支持 | | Mantle | 5000 | 5000 | 已经支持 | | Base | 8453 | 8453 | 已经支持 | | Arbitrum One | 42161 | 42161 | 已经支持 | | Avalanche C-Chain | 43114 | 43114 | 已经支持 | | Tron | 195 | | 即将支持 | | Solana | 501 | | 即将支持 | | Sui | 784 | | 即将支持 | | Stacks | 5757 | | 即将支持 | | Scroll | 534352 | 534352 | 即将支持 | [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) 目录 [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction#%E6%94%AF%E6%8C%81%E7%9A%84%E7%BD%91%E7%BB%9C) --- # 获取 Fractal Ordinals 交易历史 | Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [获取 Fractal Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Fractal Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) 获取 Fractal Ordinals 交易历史 获取 Fractal Ordinals 交易历史[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities#%E8%8E%B7%E5%8F%96-fractal-ordinals-%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2) =================================================================================================================================================================================================== 该接口用于返回某个合集下所有成交的记录，包括交易 From 和 To 地址、交易时间和交易价格等。默认按照成交时间倒序。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/trade-history` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 是 | 合集 slug 名称，即合集的唯一标识 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 10，最大 100）。每页返回最多交易历史的条数 | | sort | String | 否 | 排序规则：交易历史默认按时间倒序 `desc` 排序，可选正序 `asc` | | isBrc20 | Boolean | 否 | 获取全部 Fractal NFT 或 Brc20 合集的交易历史，默认返回 BRC-20 。 | | orderSourceList | Integer\[\] | 否 | 获取某些平台的订单，请填入代号，如\[34,54\]（34:OKX 54:Magic Eden 55:OrdinalsWallet 57:Unisat ）。 | | tradeWalletAddress | String | 否 | 交易涉及的钱包地址 | | type | String | 否 | 交易类型，多个以‘,’分割。默认返回成交数据（SALE、LIST、TRANSFER、CANCEL\_LIST、UPDATE\_PRICE） | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个 [Ordinals 交易历史模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model.html#ordinals%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | fromAddress | String | 交易 From 地址 | | inscriptionId | String | 铭文编号 | | price | String | 交易价格，FB 计价 | | timestamp | Long | 交易时间戳 | | toAddress | String | 交易 To 地址 | | unitPrice | String | 订单单价，FB 计价 | | amount | String | 订单中的铭文数量 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 Fractal NFT | | orderSource | Integer | 订单来源 | | orderSourceName | String | 订单来源名称 | | type | String | 交易类型 | [获取 Fractal Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X POST "https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/trade-history" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "slug=xxx" \ -d "limit=1" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "MTcwMTE1NTM5MDo5OTZkYzdmMjljMzM1ODJhZjEwNDhjN2ZlMDgyZTU4Y2NhMTQ0ZDA3MzY0YTdkODc4NjUyYjhkM2ZhNGI2MTc3LTAtMjMzNTc5NTYzMDUxOTUxMjI=", "data": [\ {\ "amount": "3096",\ "fromAddress": "bc1pgnwyzfjl0fmw4n87tr4stv8hyeed3fc2qnavrpkgv2cqv4vywfjsm69w7n",\ "inscriptionId": "b4f9d43757afdc94b04738577cf4d8a6f1262cff4c6f489b641c614539d285bdi0",\ "inscriptionNumber": "119738160",\ "isBrc20": true,\ "price": "6.192",\ "slug": "people",\ "timestamp": 1728991566,\ "toAddress": "bc1p9xuw2vdtk0z5m3nv3x6ljr32m4eu30u69472x6yy4rj9zsyguy0qwdu8p7",\ "unitPrice": "2000000",\ "orderSource": 84,\ "orderSourceName": "okx",\ "type": "SALE"\ }\ ] }, "msg": "" } [获取 Fractal Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) --- # 搭建 Web3 钱包 | 快速开始 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) [搭建链上数据看板](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-dashboard) [搭建铭文钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) [搭建 Web3 钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) 搭建 Web3 钱包 搭建 Web3 钱包[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E6%90%AD%E5%BB%BA-web3-%E9%92%B1%E5%8C%85) ======================================================================================================================================== 请确保已完成了[准备工作](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-preparation) ，可直接通过此案例，熟悉钱包管理、各公链数据的查询、交易构建和广播。 第一步：生成钱包助记词及地址[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%B8%80%E6%AD%A5%EF%BC%9A%E7%94%9F%E6%88%90%E9%92%B1%E5%8C%85%E5%8A%A9%E8%AE%B0%E8%AF%8D%E5%8F%8A%E5%9C%B0%E5%9D%80) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 你可以使用我们提供的 [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) 创建钱包助记词及地址。 ### npm install[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#npm-install) 首先需要安装到最新的签名 SDK 版本，以 EVM 网络为例： npm install @okxweb3/crypto-lib npm install @okxweb3/coin-base npm install @okxweb3/coin-ethereum ### 本地构建[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E6%9C%AC%E5%9C%B0%E6%9E%84%E5%BB%BA) 1. 下载项目源码 git clone https://github.com/okx/js-wallet-sdk.git 2. 运行构建脚本 sh build.sh 以 EVM 网络为例，可以依照下述代码，使用签名 SDK 创建一个 EVM 钱包对象，并且推导出所对应地址。 import { bip39, BigNumber } from "@okxweb3/crypto-lib"; import { EthWallet,MessageTypes } from "@okxweb3/coin-ethereum"; // eth wallet let wallet = new EthWallet(); // get mnemonic let mnemonic = await bip39.generateMnemonic(); console.log("generate mnemonic:", mnemonic); // get derived key const hdPath = await wallet.getDerivedPath({ index: 0 }); let derivePrivateKey = await wallet.getDerivedPrivateKey({ mnemonic: mnemonic, hdPath: hdPath }); console.log("generate derived private key:", derivePrivateKey, ",derived path: ", hdPath); // get new address let newAddress = await wallet.getNewAddress({ privateKey: derivePrivateKey }); console.log("generate new address:", newAddress.address); // get the public key let publicKey = newAddress.publicKey; console.log("the corresponding public key:", publicKey); ### 演示程序[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E6%BC%94%E7%A4%BA%E7%A8%8B%E5%BA%8F) 我们准备了一个[开源演示程序](https://okx.github.io/js-wallet-sdk-demo/) ，用于展示我们上述涉及到签名 SDK 的功能。 获取演示程序源码[点击这里](https://github.com/okx/js-wallet-sdk-demo) 。 * * * 第二步：创建账户[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%BA%8C%E6%AD%A5%EF%BC%9A%E5%88%9B%E5%BB%BA%E8%B4%A6%E6%88%B7) -------------------------------------------------------------------------------------------------------------------------------------------------------------------- 你在上一步，已经生成了助记词和地址。现在你可以创建账户 [(AccountId)](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions) 来聚合多个地址，进行批量查询代币余额和交易历史。 说明 通常情况，Web3 钱包有三个概念： \- 钱包，谁拥有助记词，谁就拥有钱包。 \- 账户，基于 BIP-44 规范，一套助记词下可以派生多个账户。 \- 地址，每个账户下的每个链，对应一个地址。 调用接口来[创建钱包账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-create-wallet-account) 。 例如，同时订阅不同链上的同一地址，实现如下： //定义你的参数 const addresses = [\ {\ "chainIndex":"1",\ "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db",\ },\ {\ "chainIndex":"10",\ "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db",\ }\ ]; const getCreateAccountBody = { addresses: addresses, }; //定义辅助函数 const getCreateAccountData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/account/create-wallet-account' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(getCreateAccountBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: createAccountData } = await getCreateAccountData(); * * * 第三步：构建并发送交易[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E9%80%81%E4%BA%A4%E6%98%93) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### 获取签名所需信息[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E8%8E%B7%E5%8F%96%E7%AD%BE%E5%90%8D%E6%89%80%E9%9C%80%E4%BF%A1%E6%81%AF) 首先，调用 `POST /api/v5/wallet/pre-transaction/sign-info` 接口，查询签名所需要的一些数据，例如 EVM 链的 gas price、gas limit、nonce 等。 //定义你的参数 // EVM const postSignInfoBody = { chainIndex: '1', fromAddr: '0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2', toAddr: '0x1e80c39051f078ee34763282cbb36ffd88b40c65', txAmount: '123000000000000', extJson: { inputData: '041bbc6fa102394773c6d8f6d634320773af4' } }; // TRON const postSignInfoBody = { "chainIndex": "195", "fromAddr": "TDnSmJ15nmwg5jmYmXWFVgBX53XxfbNHsC", "toAddr": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "txAmount": "0", "extJson": { "permissionType": 1, "feeLimit": 300000, "inputData": "0x095ea7b3000000000000000000000000d73c5e36d47eed32f0327f9d3f04b49384e90fab0000000000000000000000000000000000000000000000000000000000000000" } }; const postSignInfoBody = { chainIndex: '1', fromAddr: '0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2', toAddr: '0x1e80c39051f078ee34763282cbb36ffd88b40c65', txAmount: '123000000000000', extJson: { inputData: '041bbc6fa102394773c6d8f6d634320773af4' } }; //定义辅助函数 const signInfoData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/pre-transaction/sign-info' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(postSignInfoBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: signInfoData } = await signInfoData(); ### 验证地址构建交易[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E9%AA%8C%E8%AF%81%E5%9C%B0%E5%9D%80%E6%9E%84%E5%BB%BA%E4%BA%A4%E6%98%93) 使用签名 SDK 先验证地址合法性再构建交易 // Verify address let valid = await wallet.validAddress({ address: newAddress.address }); console.log("verify address isValid:", valid.isValid); // Sign a transaction let signParams = { privateKey: derivePrivateKey, data: { to: newAddress.address, value: new BigNumber(0), nonce: 5, gasPrice: new BigNumber(100 * 1000000000), gasLimit: new BigNumber(21000), chainId: 42 } }; let signedTx = await wallet.signTransaction(signParams); console.log("signed tx:", signedTx); ### 广播交易[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E5%B9%BF%E6%92%AD%E4%BA%A4%E6%98%93) 调用[接口](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) ，交易广播到链上。 //定义你的参数 const postSendTransactionBody = { "signedTx": "0x02f8720182029f8411e1a3008504bbe2e94682520894d73c5e36d47eed32f0327f9d3f04b49384e90fab85e8d4a5100080c080a0ba380a9be31efabc4c8cfccbb555f8af3c21073d6eca01f180ebebb8942c6f30a0779e6e16a504c413cb9902ceb33ab7e89a533bc13b74477dfa6b6c76dc41fac2 "accountId": "5f45a951-4a8b-4cd9-b20a-3b337b71efcc", "chainIndex": "1", "address": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3", }; //定义辅助函数 const sendTransactionData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, 'api/v5/wallet/pre-transaction/broadcast-transaction' ); return fetch(apiRequestUrl, { method: 'post', headers: headersParams, body: JSON.stringify(postSendTransactionBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: sendTransactionData } = await sendTransactionData(); 广播后，你将收到如下的响应： { "code": 0, "msg": "success", "data": [{\ "orderId": "469356614923743232"\ }] } 说明 点击查看 [orderId](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-definitions#orderid) 的定义 * * * 第四步：查询交易详情[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E5%9B%9B%E6%AD%A5%EF%BC%9A%E6%9F%A5%E8%AF%A2%E4%BA%A4%E6%98%93%E8%AF%A6%E6%83%85) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 当发送交易后，使用[接口](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) 来获取交易详情信息。也可查看[查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) 来获取交易详情信息。 //定义你的参数 const params = { accountId: '13886e05-1265-4b79-8ac3-b7ab46211001', orderId: '469356614923743232', chainIndex: '1' }; //定义辅助函数 const getTransactionDetailData = async () => { const apiRequestUrl = getRequestUrl( apiBaseUrl, '/api/v5/wallet/post-transaction/transaction-detail-by-ordid', params ); return fetch(apiRequestUrl, { method: 'get', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; const { data: transactionDetailData } = await getTransactionDetailData(); 查询详情成功后，你将收到如下的响应： { "code": 0, "msg": "success", "data": [\ {\ "chainIndex": "1",\ "orderId": "469356614923743232",\ "txhash": "0xcbf411766d65f3cf92839ababa73c4afec69a83442e8b67a68b5104b50a04ejb",\ "blockHash" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",\ "blockHeight" : "19235519",\ "blockTime" : "1708026551000",\ "feeUsdValue" : "138.846919",\ "fees" : "49102595635945621",\ "gasLimit" : "2000000",\ "gasPrice" : "87504603347",\ "gasUsed" : "561143",\ "txType": "0", \ "txTime": "0", \ "txStatus": "0",\ "txDetail": [\ {\ "iType" : "0", \ "txAmount": "0",\ "tokenAddress":""\ "contractCall" : true,\ "fromAddr" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",\ "toAddr" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",\ "logIndex" : "-1",\ "status" : "SUCCESS"\ }\ ]\ }\ ] } 此外，你还可以通过订阅 Webhook，实时准确地了解交易发送后的状态，[查看详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-webhook-intro) 。 * * * 到这里，你基本上已经实现了开发一款 Web3 钱包所需的部分基础功能。 此外，钱包 API 提供了丰富接口，全方位满足 Web3 钱包开发者的需求，请查看下方章节查看更多内容。 [搭建铭文钱包](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-inscription) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) 目录 [第一步：生成钱包助记词及地址](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%B8%80%E6%AD%A5%EF%BC%9A%E7%94%9F%E6%88%90%E9%92%B1%E5%8C%85%E5%8A%A9%E8%AE%B0%E8%AF%8D%E5%8F%8A%E5%9C%B0%E5%9D%80) [第二步：创建账户](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%BA%8C%E6%AD%A5%EF%BC%9A%E5%88%9B%E5%BB%BA%E8%B4%A6%E6%88%B7) [第三步：构建并发送交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E9%80%81%E4%BA%A4%E6%98%93) [第四步：查询交易详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E5%9B%9B%E6%AD%A5%EF%BC%9A%E6%9F%A5%E8%AF%A2%E4%BA%A4%E6%98%93%E8%AF%A6%E6%83%85) --- # 获取热门合集 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Runes API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) 获取热门合集 获取热门合集[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections#%E8%8E%B7%E5%8F%96%E7%83%AD%E9%97%A8%E5%90%88%E9%9B%86) ===================================================================================================================================================== 该接口用于获取热门合集的交易数据。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/runes/get-hot-collection` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **是否必传** | **参数说明** | | --- | --- | --- | --- | | timeType | Integer | 否 | 返回 x 个项目的数据，并按照项目在对应时间范围内的交易额从高到低排序。 枚举值：1.24h 2.7d 3.30d 4.all 不传则默认 24h 交易额 | | cursor | String | 否 | 查询列表分页游标，默认为空 | | limit | Integer | 否 | 查询列表页大小，默认为 10 | ### 返回参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections#%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0) | **参数** | **类型** | **参数说明** | | --- | --- | --- | | cusor | String | 游标，处理分页 | | runesId | String | runeid | | name | String | 符文名称 | | spaceName | String | 加点后的符文名称 | | maxMintNumber | String | 最多 mint 数量 | | mintedNumber | String | 已铸造数量 | | limitPerMint | String | 单笔 mint 上限 | | deployedTime | Long | 部署时间 | | startBlock | String | 起始区块 | | endBlock | String | 结束区块 | | symbol | String | 符号 | | divisibility | Integer | 精度 | | collectionUrl | String | OKX 合集链接 | | totalVolume | String | 时间范围内交易额，BTC 和美元分别计价 | | usdTotalVolume | String | 时间范围内交易额，USD 计价 | | marketCap | String | 市值，BTC 计价 | | usdMarketCap | String | 市值，USD 计价 | | floorprice | String | 地板价，Sats 计价 | | usdFloorPrice | String | 地板价，USD 计价 | | holders | Integer | 持有地址数 | | salesCount | Integer | 成交数量 | | volumeGains | String | 交易额涨幅 | [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/mktplace/nft/runes/get-hot-collection?timeType=2&cursor=Mg%3D%3D' \ --header 'OK-ACCESS-PASSPHRASE: xxxxxx' \ --header 'OK-ACCESS-KEY: xxxx' \ ### 返回示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections#%E8%BF%94%E5%9B%9E%E7%A4%BA%E4%BE%8B) 200 { "code":0, "data":{ "items":[\ {\ "collectionUrl":"https://web3.okx.com/web3/marketplace/runes/token/DOG•GO•TO•THE•MOON/840000:3",\ "deployedTime":1713571767,\ "divisibility":5,\ "marketData":{\ "floorPrice":"10.6509577683",\ "holders":72903,\ "marketCap":"10651.030343051788712385",\ "salesCount":35436,\ "totalVolume":"1124.64783456999999",\ "usdFloorPrice":"0.006598097922137557",\ "usdMarketCap":"659814288.103509427870310934",\ "usdTotalVolume":"69670133.915076187380516"\ },\ "maxMintNumber":"100000000000",\ "mintedNumber":"100000000000",\ "name":"DOG•GO•TO•THE•MOON",\ "runesId":"840000:3",\ "spaceName":"DOGGOTOTHEMOON",\ "startBlock":840000,\ "symbol":"🐕"\ }\ ], "cursor":"" }, "msg":"" } [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) --- # FAQ | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) FAQ FAQ[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#faq) ============================================================================= 限价和兑换的区别是什么？[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E9%99%90%E4%BB%B7%E5%92%8C%E5%85%91%E6%8D%A2%E7%9A%84%E5%8C%BA%E5%88%AB%E6%98%AF%E4%BB%80%E4%B9%88%EF%BC%9F) ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 兑换会以实时市价进行交易，而限价单可以以指定价格进行交易，使用限价单能获得自主定价权。闪兑不用等待即可直接成交，而限价单只有当代币价格达到预设价格时才会成交。 限价单的交易对手方是谁？[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E9%99%90%E4%BB%B7%E5%8D%95%E7%9A%84%E4%BA%A4%E6%98%93%E5%AF%B9%E6%89%8B%E6%96%B9%E6%98%AF%E8%B0%81%EF%BC%9F) ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- API 限价单为欧易 DEX 提供流动性来源，交易对手方是欧易 DEX 的用户。用户在欧易 DEX 中进行交易时，一旦与来自限价单的执行路径相匹配，便会完成交易。 网络费用如何收取？[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E7%BD%91%E7%BB%9C%E8%B4%B9%E7%94%A8%E5%A6%82%E4%BD%95%E6%94%B6%E5%8F%96%EF%BC%9F) ----------------------------------------------------------------------------------------------------------------------------------------------------------------- 网络费用在执行订单时才会收取，挂单及撤单都不收取网络费用。API 限价单的网络费用由交易对手方支付。 为什么预设价格达到了市价而限价单却没有即刻成交？[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E4%B8%BA%E4%BB%80%E4%B9%88%E9%A2%84%E8%AE%BE%E4%BB%B7%E6%A0%BC%E8%BE%BE%E5%88%B0%E4%BA%86%E5%B8%82%E4%BB%B7%E8%80%8C%E9%99%90%E4%BB%B7%E5%8D%95%E5%8D%B4%E6%B2%A1%E6%9C%89%E5%8D%B3%E5%88%BB%E6%88%90%E4%BA%A4%EF%BC%9F) ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 未成交的原因有以下两种： 1. 尽管市价达到了你的预设价格，但如果没有足够的流动性来完成订单，订单仍无法被成交。 2. 如果欧易 DEX 中没有交易对手方能完成订单交易，那么交易也不会被执行。 为什么限价单不能卖出 ETH？[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E4%B8%BA%E4%BB%80%E4%B9%88%E9%99%90%E4%BB%B7%E5%8D%95%E4%B8%8D%E8%83%BD%E5%8D%96%E5%87%BA-eth%EF%BC%9F) --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 由于 ETH 不是 ERC-20 代币。欧易 DEX 的限价单目前仅适用于 ERC-20 代币。如果你希望使用限价订单出售 ETH，你可以 wrap 你的 ETH 并使用 WETH 作为卖出币种。 [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 目录 [限价和兑换的区别是什么？](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E9%99%90%E4%BB%B7%E5%92%8C%E5%85%91%E6%8D%A2%E7%9A%84%E5%8C%BA%E5%88%AB%E6%98%AF%E4%BB%80%E4%B9%88%EF%BC%9F) [限价单的交易对手方是谁？](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E9%99%90%E4%BB%B7%E5%8D%95%E7%9A%84%E4%BA%A4%E6%98%93%E5%AF%B9%E6%89%8B%E6%96%B9%E6%98%AF%E8%B0%81%EF%BC%9F) [网络费用如何收取？](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E7%BD%91%E7%BB%9C%E8%B4%B9%E7%94%A8%E5%A6%82%E4%BD%95%E6%94%B6%E5%8F%96%EF%BC%9F) [为什么预设价格达到了市价而限价单却没有即刻成交？](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E4%B8%BA%E4%BB%80%E4%B9%88%E9%A2%84%E8%AE%BE%E4%BB%B7%E6%A0%BC%E8%BE%BE%E5%88%B0%E4%BA%86%E5%B8%82%E4%BB%B7%E8%80%8C%E9%99%90%E4%BB%B7%E5%8D%95%E5%8D%B4%E6%B2%A1%E6%9C%89%E5%8D%B3%E5%88%BB%E6%88%90%E4%BA%A4%EF%BC%9F) [为什么限价单不能卖出 ETH？](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq#%E4%B8%BA%E4%BB%80%E4%B9%88%E9%99%90%E4%BB%B7%E5%8D%95%E4%B8%8D%E8%83%BD%E5%8D%96%E5%87%BA-eth%EF%BC%9F) --- # 获取铭文资产列表 | Fractal Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [获取 Fractal Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-collection-list) [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Fractal Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) 获取铭文资产列表 获取铭文资产列表[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions#%E8%8E%B7%E5%8F%96%E9%93%AD%E6%96%87%E8%B5%84%E4%BA%A7%E5%88%97%E8%A1%A8) ================================================================================================================================================================================= 该接口用于获取指定地址上的 Fractal NFT 和 BRC-20 合集的铭文资产，包括铭文数量，币种和 NFT ID。默认按照成交时间倒序。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/get-valid-inscriptions` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 是 | 合集 slug 名称，即合集的唯一标识 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小 (默认值 10，最大 100)。返回最大的合集数 | | sort | String | 否 | 挂单排序规则：listing\_time\_desc：订单创建时间最新的在前 listing\_time\_asc：订单创建时间最早的在前 price\_desc：价格最高的在前 price\_asc：价格最低的在前 unit\_price\_desc：单价最高的在前 unit\_price\_asc：单价最低的在前 默认排序为订单创建时间最新的在前 | | isBrc20 | Boolean | 否 | 获取全部 Fractal NFT 或 BRC-20 合集的列表，默认为 BRC-20 | | walletAddress | String | 是 | 获取铭文的钱包地址 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 铭文数据的列表 | **参数** | **类型** | **描述** | | --- | --- | --- | | inscriptionId | String | 铭文 ID | | cursor | String | 现在指向的游标 | | nftId | String | 铭文 NFT ID 是唯一标识 | | ticker | String | 币种 | | tickerId | String | 币种的 ID | | amount | String | 铭文数量 | [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) ### 代码请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions#%E4%BB%A3%E7%A0%81%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/get-valid-inscriptions' \ --header 'OK-ACCESS-KEY: your API key' \ --header 'OK-ACCESS-PASSPHRASE: your passphrase' \ --header 'Content-Type: application/json' \ --data '{ "slug": "Fractal Ordinals", "walletAddress": "bc1qek.....27zgdgqfawx", "limit": "10", "isBrc20": false }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-get-inscriptions#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "MTY5N.......WZhd3g=", "inscriptionInfos": [\ {\ "amount": "1",\ "inscriptionId": "ad14bd7fa6afee2bc37681f6...9b949746d258e0c8133c259a94198febf66bi0",\ "nftId": "17407619...517490",\ "ticker": "",\ "tickerId": ""\ },\ {\ "amount": "1",\ "inscriptionId": "6f776f43d119094...37ce8abab7aea902a4455fc7b8b319122880f71a1ci0",\ "nftId": "16635...80929138",\ "ticker": "",\ "tickerId": ""\ },\ {\ "amount": "1",\ "inscriptionId": "e0ae7e1ee159...d836fe692b1fb6b25911f9f6edec666da9fb090fdffe4i0",\ "nftId": "166355152...29586",\ "ticker": "",\ "tickerId": ""\ }\ ] }, "msg": "" } [获取 Fractal Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-retrieve-ordinal-activities) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) --- # 获取钱包资产 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Runes API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) 获取钱包资产 获取钱包资产[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset#%E8%8E%B7%E5%8F%96%E9%92%B1%E5%8C%85%E8%B5%84%E4%BA%A7) ======================================================================================================================================= 该接口用于获取某个地址下的符文资产 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/runes/get-owned-asserts` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **字段名** | **类型** | **是否必传** | **说明** | | --- | --- | --- | --- | | runesId | String | 是 | 代币的唯一标识 | | walletAddresses | String | 是 | 钱包地址，多个地址则以英文逗号分隔 (,)，钱包地址不超过 20 个 | | cursor | String | 否 | 指向要检索的排序序号的游标 (最大 1,000) | | limit | Integer | 否 | 分页大小 (默认值 10，最大 100)。返回最大的条数 | ### 返回参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset#%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0) | **参数** | **类型** | **参数说明** | | --- | --- | --- | | assetId | String | id (DB 主键 无实际意义) | | tickerType | Integer | 代币类型 (4-Runes) | | ticker | String | 代币名称 | | tickerId | String | 代币 id | | ownerAddress | String | 钱包地址 | | amount | String | 在该 UTXO 的 XRC20 数量 | | chain | Integer | 链 | | inscriptionNum | String | Inscription 编号 | | utxoTxHash | String | 交易 hash | | utxoVout | Integer | utxoVout | | utxoValue | String | utxoValue | | txHash | String | 交易 hash | | name | String | 代币名称 | | tickerIcon | String | 代币 icon 链接 | | status | Integer | 挂单状态 (0-未挂单 1-已挂单 2-pending中) | | listTime | Long | 挂单时间 | | orderId | Long | 订单 id | | confirmations | Long | 区块高度信息 | | currency | String | 总价 - 币种 | | currencyUrl | String | 总价 - 币种 url | | satPrice | BigDecimal | 总价 - sat 价格 | | price | BigDecimal | 总价 - btc 价格 | | usdPrice | BigDecimal | 总价 - usd 价格 | | currency | String | 单价 - 币种 | | currencyUrl | String | 单价 - 币种 url | | satPrice | BigDecimal | 单价 - sat 价格 | | price | BigDecimal | 单价 - btc 价格 | | usdPrice | BigDecimal | 单价 - usd 价格 | | unavailable | Integer | "1 - 同一个 UTXO 包含 多个 Atomicals 资产； 2 - 同一个 UTXO 包含多个协议资产" | | symbol | String | Symbol | [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://beta.okex.org/api/v5/mktplace/nft/runes/get-owned-asserts?runesId=840000:3&walletAddresses=bc1p3fj806enwnmz04444mpm42ykgdcta9p5mvzx46hp8wmg2knpwxpq0k46x9&limit=10' \ --header 'OK-ACCESS-KEY: XXXX' \ --header 'OK-ACCESS-PASSPHRASE: XXXX' ### 返回示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset#%E8%BF%94%E5%9B%9E%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "1", "items": [\ {\ "amount": "500000",\ "assetId": "28912795273673038",\ "chain": 0,\ "confirmations": null,\ "inscriptionNum": "",\ "listTime": 1714399069,\ "name": "DOG•GO•TO•THE•MOON",\ "orderId": 201296,\ "ownerAddress": "bc1p3fj806enwnmz04444mpm42ykgdcta9p5mvzx46hp8wmg2knpwxpq0k46x9",\ "status": 1,\ "symbol": "🐕",\ "ticker": "DOG•GO•TO•THE•MOON",\ "tickerIcon": "https://static.coinall.ltd/cdn/web3/currency/token/1714125941761.png/type=png_350_0",\ "tickerId": "840000:3",\ "tickerType": 4,\ "totalPrice": {\ "currency": "BTC",\ "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",\ "price": "0.031895",\ "satPrice": "3189500",\ "usdPrice": "1979.7003235"\ },\ "txHash": "",\ "unavailable": null,\ "unitPrice": {\ "currency": "BTC",\ "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",\ "price": "0.00000006379",\ "satPrice": "6.379",\ "usdPrice": "0.003959400647"\ },\ "utxoTxHash": "ce302f5c946ff3ef502eade58405d64b545d59de9fcd731314b88ddadf709ca6",\ "utxoValue": "546",\ "utxoVout": 2\ }\ ] }, "msg": "" } [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) --- # 快速开始 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) 快速开始 快速开始[#](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B) ================================================================================================================ 在本指南中，我们将向你展示如何在 OKX 上创建铭文挂单。注意：降价时同样可以执行以下步骤。此过程包括： * 获取有效铭文 * 获取 UTXO 信息 * 获取 PSBT * 挂单铭文 1\. 获取有效铭文[#](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#1.--%E8%8E%B7%E5%8F%96%E6%9C%89%E6%95%88%E9%93%AD%E6%96%87) -------------------------------------------------------------------------------------------------------------------------------------------- 首先，你需要获取钱包地址下可用的铭文资产，以便在 OKX 平台上挂单。详情见[获取铭文资产列表](https://web3.okx.com/cn/web3/build/docs/waas/marketplace-ordinals-get-inscriptions) 。 步骤 1：构建请求 const apiBaseUrl = 'https://web3.okx.com'; const requestUrl = '/api/v5/mktplace/nft/ordinals/get-valid-inscriptions'; // const originalMessage = JSON.stringify({ slug: 'BTC Ordinals', walletAddress: 'bc1qek7lal8ghnmus3dw897atlpgvmv27zgdgqfawx', limit: '10', isBrc20: false // true for brc20 tokens. Note: Default value is true if not included }); const apiRequestUrl = getRequestUrl(apiBaseUrl, requestUrl); const headersParams = { 'Content-Type': 'application/json', 'OK-ACCESS-KEY': apiKey, 'OK-ACCESS-SIGN': cryptoJS.enc.Base64.stringify( cryptoJS.HmacSHA256(timestamp + 'POST' + '/api/v5/mktplace/nft/ordinals/get-valid-inscriptions' + originalMessage , secretKey) ), 'OK-ACCESS-TIMESTAMP': timestamp, 'OK-ACCESS-PASSPHRASE': passphrase, }; 步骤 2：发出请求 return fetch(apiRequestUrl, {method: 'post', headers: headersParams, body: originalMessage}) .then((res) => { console.log(res) return res.json() } ).then((res) => { console.log(JSON.stringify(res)) return res; }); { "code": 0, "data": { "cursor": "MTY5MDQ1NzA3NTE2OToxNjgwMzUxMDg4MDMwO...3Z3Z2xjbWo4dGg0cXF6amVxbGtweXVxbGp3Y3AyMDh4MzM3ZmV4cDI2cDBteHA4cXQ4MjB4ZA==", "inscriptionInfos": [\ {\ "amount": "1",\ "inscriptionId": "08ea6e794016c8f11ddb262...15ba29a6f54d3c75fd184a9i0",\ "nftId": "1651480...458",\ "ticker": "",\ "tickerId": ""\ },\ {\ "amount": "1",\ "inscriptionId": "0c3020593597d1f58188...23cbcb91d9b7fb8e3e0cefa0b2dfi0",\ "nftId": "2105134...741490",\ "ticker": "",\ "tickerId": ""\ }\ ] }, "msg": "" } 2\. 获取 UTXO 信息[#](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#2.--%E8%8E%B7%E5%8F%96-utxo-%E4%BF%A1%E6%81%AF) ------------------------------------------------------------------------------------------------------------------------------------ 为了获取交易的 PSBT，需要获取铭文的 UTXO。因此，你将需要 inscriptionId 来查询 UTXO。详情见[查询 UTXO](https://web3.okx.com/cn/web3/build/docs/waas/api-transaction-get-utxo) 。 步骤 1：构建新的请求参数去获取 UTXO 信息 const apiBaseUrl = 'https://web3.okx.com'; const requestUrl = '/api/v5/waas/transaction/get-utxo'; // this endpoint is to get UTXO information of the inscription const utxoRequestBody = JSON.stringify({ chainId:0, utxoRequests: [\ {\ address: "bc1p9npkvwglc...ljwcp208x337fexp26p0mxp8qt820xd", // the wallet that holds the inscription\ coinAmount: 0, // use default value 0\ serviceCharge: 0, // use default value 0\ utxoType: 2, // default type 2 for utxo inscription check\ nftId: "1803359c...cfeb15d1aa6ade40i0" // this is inscription ID\ }\ ] }) const apiRequestUrl = getRequestUrl(apiBaseUrl, requestUrl); const headersParams = { 'Content-Type': 'application/json', 'OK-ACCESS-KEY': apiKey, 'OK-ACCESS-SIGN': cryptoJS.enc.Base64.stringify( cryptoJS.HmacSHA256(timestamp + 'POST' + requestUrl + utxoRequestBody , secretKey) ), 'OK-ACCESS-TIMESTAMP': timestamp, 'OK-ACCESS-PASSPHRASE': passphrase, }; 步骤 2：获取 UTXO 信息 return fetch(apiRequestUrl, {method: 'post', headers: headersParams, body: utxoRequestBody}) .then((res) => { console.log(res) return res.json() } ).then((res) => { console.log(JSON.stringify(res)) return res; }); 请求返回 { "address": "bc1pt5w9...2m8cky8qxjn3rg", "canTransferAmount": "0", "utxoType": 2, "totalUtxoNum": 0, "utxoList": [\ {\ "txHash": "02ecbe7ef51...87a7c6e64409883f66f4e3036",\ "vout": 0,\ "coinAmount": 546,\ "confirmations": 3548,\ "utxoType": 2,\ "status": 1,\ "utxoBizStatus": 0,\ "hasNft": true,\ "hasCheckNftExist": true,\ "nftLocaltionVOs": [\ {\ "nftId": "02ecbe7ef5143...3f3de87a7c6e64409883f66f4e3036i0", // this is inscriptionId\ "nftLocation": "02ecbe7ef51431...fccb83f3de87a7c6e64409883f66f4e3036:0:0",\ "nftType": 2,\ "brc20Nft": true\ }\ ],\ "key": "02ecbe7ef514311523d0e7f...3f3de87a7c6e64409883f66f4e3036-0",\ "dummy": false,\ "spending": false\ }\ ] } 3\. 签署 PSBT[#](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#3.-%E7%AD%BE%E7%BD%B2-psbt) ------------------------------------------------------------------------------------------------------------- 接下来，我们需要设置挂单价，得到挂单的 PSBT。详情见[钱包 SDK](https://github.com/okx/js-wallet-sdk/blob/main/packages/coin-bitcoin/src/psbtSign.ts) 。 注意 降价时如果定价不低于当前价格，会返回错误。当挂单价格低于 0.00001 BTC 时也会返回错误。 步骤 1：构建 PSBT 数据 import { generateSignedListingPsbt, networks } from '@okxweb3/coin-bitcoin'; const listingData = { nftAddress: 'bc1pt5w9...2m8cky8qxjn3rg', nftUtxo: { txHash: '02ecbe7ef51...87a7c6e64409883f66f4e3036', vout: 0, coinAmount: 546, rawTransaction: undefined }, receiveBtcAddress: 'bc1p9npkvwglcmj8th4q...cp208x337fexp26p0mxp8qt820xd', // your btc wallet address price: 10000 // total price in Satoshi unit } 步骤 2: 使用 OKT 钱包 SDK 获取 PSBT const psbt = generateSignedListingPsbt(listingData, privateKey, networks.bitcoin); console.log(psbt); 4\. 挂单铭文[#](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#4.-%E6%8C%82%E5%8D%95%E9%93%AD%E6%96%87) ----------------------------------------------------------------------------------------------------------------------- 通过 PSBT 签名和挂单信息来请求在 OKX 挂单。 步骤1：构建挂单请求 注意 unitPrice 对于 BRC-20 或 BTC NFT 会有所不同。对于 BTC NFT，它将与 totalPrice 相同，因为 BTC NFT 的数量为 1，但对于 BRC-20，unitPrice 将是 totalPrice 除以铭文的数量。例如，totalPrice为 10000 聪，铭文数量为 50，则 unitPrice 将为 10000/50=200。 const apiBaseUrl = 'https://web3.okx.com'; const requestUrl = '/api/v5/mktplace/nft/ordinals/okx/make-orders'; // this endpoint is to get UTXO information of the inscription const submitListingBody = JSON.stringify({ brc20: false, items: [\ {\ inscriptionId: inscriptionId,\ nftId: nftId, // get this data part 1 step 2 by mapping it to inscriptionId\ orderType: 2,\ totalPrice: 100000, // this price should match part 3 step 1\ unitPrice: 100000, // this price will varies for BRC20 or btc NFT. Check out Note on unitPrice\ psbt: 'cHNidP8BAP0GAQIAAAADAAAAAAAAAAAAAAAAAAAAAA...GJSkBSJuPsgb2gGCekW+W04EtAAAAAA=',\ }\ ], tickerId: '' }) const apiRequestUrl = getRequestUrl(apiBaseUrl, requestUrl); const headersParams = { 'Content-Type': 'application/json', 'OK-ACCESS-KEY': apiKey, 'OK-ACCESS-SIGN': cryptoJS.enc.Base64.stringify( cryptoJS.HmacSHA256(timestamp + 'POST' + requestUrl + submitListingBody , secretKey) ), 'OK-ACCESS-TIMESTAMP': timestamp, 'OK-ACCESS-PASSPHRASE': passphrase, }; 步骤 2：发出请求 return fetch(apiRequestUrl, {method: 'post', headers: headersParams, body: submitListingBody}) .then((res) => { console.log(res) return res.json() } ).then((res) => { console.log(JSON.stringify(res)) return res; }); 最后成功挂单 { "result": [\ {\ "nftID": 20824...473273458, // should be the same nftId as part 4 step 1\ "errorMsg": "",\ "success": true,\ }\ ] } [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) 目录 [1\. 获取有效铭文](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#1.--%E8%8E%B7%E5%8F%96%E6%9C%89%E6%95%88%E9%93%AD%E6%96%87) [2\. 获取 UTXO 信息](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#2.--%E8%8E%B7%E5%8F%96-utxo-%E4%BF%A1%E6%81%AF) [3\. 签署 PSBT](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#3.-%E7%AD%BE%E7%BD%B2-psbt) [4\. 挂单铭文](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start#4.-%E6%8C%82%E5%8D%95%E9%93%AD%E6%96%87) --- # 获取 Ordinals 订单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) 获取 Ordinals 订单 获取 Ordinals 订单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings#%E8%8E%B7%E5%8F%96-ordinals-%E8%AE%A2%E5%8D%95) ===================================================================================================================================================== 该接口用于返回指定合集下所有有效订单。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/ordinals/listings` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 否 | 合集 slug 名称，即合集的唯一标识 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 10，最大 100）。返回最大的订单数 | | sort | String | 否 | 挂单排序规则：
`listing_time_desc`：订单创建时间最新的在前
`listing_time_asc`：订单创建时间最早的在前
`price_desc`：价格最高的在前
`price_asc`：价格最低的在前
`unit_price_desc`：单价最高的在前
`unit_price_asc`：单价最低的在前。
默认排序为订单创建时间最新的在前。 | | isBrc20 | Boolean | 否 | 获取全部 BTC NFT 或 Brc20 合集的订单，默认为 Brc20 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个 [Ordinals 订单模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model.html#ordinals%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | inscriptionId | String | 铭文编号 | | listingTime | Long | 挂单时间 | | listingUrl | String | 订单所在页面链接 | | ownerAddress | String | 订单所有者 | | price | String | 订单价格，BTC 计价 | | unitPrice | String | 订单单价，BTC 计价 | | amount | String | 订单中的铭文数量 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT | [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/ordinals/listings" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "slug=sats" \ -d "limit=1" \ -d "sort=unit_price_asc" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "MC4wOjMxNDIwNjY5MTE=", "data": [\ {\ "amount": "100",\ "inscriptionId": "8c9c19c9c2f54a7c3f19848a79f360746431d80bc2fa376146ab61743e4a514ai0",\ "isBrc20": true,\ "listingTime": 1701075376,\ "listingUrl": "https://web3.okx.com/web3/marketplace/nft/asset/btc/8c9c19c9c2f54a7c3f19848a79f360746431d80bc2fa376146ab61743e4a514ai0",\ "ownerAddress": "bc1p8a0ndtmczmmyvjv52280hf7zpl3qzml427eyfw6cjdjhc7ys4yxsvder0w",\ "price": "0.002",\ "slug": "sats",\ "unitPrice": "0"\ }\ ] }, "msg": "" } [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) --- # 获取订单信息 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Runes API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) 获取订单信息 获取订单信息[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings#%E8%8E%B7%E5%8F%96%E8%AE%A2%E5%8D%95%E4%BF%A1%E6%81%AF) ========================================================================================================================================== 该接口用于获取订单信息，支持通过 runesid 获取指定项目订单信息。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/runes/get-runes-order-list` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **字段名** | **类型** | **是否必传** | **说明** | | --- | --- | --- | --- | | runesId | String | 是 | runes 代币的唯一标识 | | cursor | String | 否 | 指向要检索的排序序号的游标 (最大 1,000) | | limit | Integer | 否 | 分页大小 (默认值 10，最大 100)。返回最大的订单数 | | sortBy | String | 否 | 订单排序规则，默认排序为单价正序排列 (unitPriceAsc)。排序枚举： unitPriceAsc、unitPriceDesc、totalPriceAsc、totalPriceDesc、listedTimeAsc、listedTimeDesc | ### 返回参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings#%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0) | **参数** | **类型** | **参数说明** | | --- | --- | --- | | assetId | Integer | id (DB 主键 无实际意义) | | tickerType | String | 代币类型 (4-Runes) | | ticker | Integer | 代币名称 | | tickerId | String | 代币 id | | ownerAddress | String | 钱包地址 | | amount | String | 在该 UTXO 的 XRC20 数量 | | chain | Integer | 链 | | inscriptionNum | String | Inscription 编号 | | utxoTxHash | String | 交易 hash | | utxoVout | Integer | utxoVout | | utxoValue | String | utxoValue | | txHash | String | 交易 hash | | name | String | 代币名称 | | tickerIcon | String | 代币 icon 链接 | | status | Integer | 挂单状态 (0-未挂单 1-已挂单 2-pending 中) | | listTime | Long | 挂单时间 | | orderId | Long | 订单 id | | confirmations | Long | 区块高度信息 | | currency | String | 总价 - 币种 | | currencyUrl | String | 总价 - 币种 url | | satPrice | BigDecimal | 总价 - sat 价格 | | price | BigDecimal | 总价 - btc 价格 | | usdPrice | BigDecimal | 总价 - usd 价格 | | currency | String | 单价 - 币种 | | currencyUrl | String | 单价 - 币种 url | | satPrice | BigDecimal | 单价 - sat 价格 | | price | BigDecimal | 单价 - btc 价格 | | usdPrice | BigDecimal | 单价 - usd 价格 | | unavailable | Integer | "1 - 同一个 UTXO 包含 多个 Atomicals 资产； 2 - 同一个 UTXO 包含多个协议资产" | | symbol | String | Symbol | [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://beta.okex.org/api/v5/mktplace/nft/runes/get-runes-order-list?runesId=840000:3' \ --header 'OK-ACCESS-KEY: XXXX' \ --header 'OK-ACCESS-PASSPHRASE: XXXX' ### 返回示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings#%E8%BF%94%E5%9B%9E%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "1", "items": [\ {\ "amount": "889806",\ "assetId": "28734126488062286",\ "chain": 0,\ "confirmations": null,\ "inscriptionNum": "",\ "listTime": 1714398972,\ "name": "DOG•GO•TO•THE•MOON",\ "orderId": 201268,\ "ownerAddress": "bc1pxav32udnt0062dlvmjn7tp3qneamudpg492t7qmxsu7m73ldd7uq768q8p",\ "status": 1,\ "symbol": "🐕",\ "ticker": "DOG•GO•TO•THE•MOON",\ "tickerIcon": "https://static.coinall.ltd/cdn/web3/currency/token/1714125941761.png/type=png_350_0",\ "tickerId": "840000:3",\ "tickerType": 4,\ "totalPrice": {\ "currency": "BTC",\ "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",\ "price": "0.05472306",\ "satPrice": "5472306",\ "usdPrice": "3388.298650632"\ },\ "txHash": "",\ "unavailable": null,\ "unitPrice": {\ "currency": "BTC",\ "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",\ "price": "0.0000000615",\ "satPrice": "6.15",\ "usdPrice": "0.0038079078"\ },\ "utxoTxHash": "80efaeffcbf70be91579afb631e45cd28df75b0883f45525d1bb6b04b21969f3",\ "utxoValue": "546",\ "utxoVout": 1015\ }\ ] }, "msg": "" } [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) --- # 获取交易历史 | Runes API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [获取合集信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-get-runes-collection) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取订单信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-listings) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-create-listing) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Runes API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) 获取交易历史 获取交易历史[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history#%E8%8E%B7%E5%8F%96%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2) =============================================================================================================================================== 该接口用于获取合集下的成交数据（最近成交价、数量），支持通过runesid获取指定项目成交事件。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/runes/trade-history` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **字段名** | **类型** | **是否必传** | **说明** | | --- | --- | --- | --- | | runesIds | String | 否 | 代币唯一标识，如果多个以英文逗号(,)分隔，不超过20个，空串会查询所有代币的交易历史 | | cursor | String | 否 | 指向要检索的排序序号的游标 | | limit | Integer | 否 | 分页大小（默认值 10，最大100）。返回最大的交易历史数 | | startTime | Long | 否 | 交易动态的起始时间（单位：秒） | | endTime | Long | 否 | 交易动态的截止时间（单位：秒） | ### 返回参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history#%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0) | **参数** | **类型** | **参数说明** | | --- | --- | --- | | runesId | String | runesId | | name | String | 代币名称 | | txHash | String | 交易hash | | typeName | String | activity-类型名称（SALE、TRANSFER等） | | amount | String | 代币数量 | | from | String | from地址 | | to | String | to地址 | | createOn | Date | 创建时间 | | platformName | Long | 平台名称 | | currency | String | 总价 - 币种 | | currencyUrl | String | 总价 - 币种 url | | satPrice | BigDecimal | 总价 - sat 价格 | | price | BigDecimal | 总价 - btc 价格 | | usdPrice | BigDecimal | 总价 - usd 价格 | | currency | String | 单价 - 币种 | | currencyUrl | String | 单价 - 币种 url | | satPrice | BigDecimal | 单价 - sat 价格 | | price | BigDecimal | 单价 - btc 价格 | | usdPrice | BigDecimal | 单价 - usd 价格 | | status | Integer | 状态，1：成功，2：pending | [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://beta.okex.org/api/v5/mktplace/nft/runes/trade-history?runesIds=840000:3&type=SALE&startTime=1713604337&endTime=1713607937' \ --header 'OK-ACCESS-KEY: XXXX' \ --header 'OK-ACCESS-PASSPHRASE: XXXX' ### 返回示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-trade-history#%E8%BF%94%E5%9B%9E%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "activityList": [\ {\ "amount": "3360",\ "createOn": 1714398184000,\ "from": "bc1p0a9xxqvh7c4l3xzcxuhdmsntlau69jnzu79jau20fza8676lfwmqnyy393",\ "name": "RSIC•GENESIS•RUNE",\ "platformName": "OKX",\ "runesId": "840000:28",\ "status": 1,\ "to": "bc1pnhukwhm2vmgsepkfxjyccgv2l0h2nu4fq0dchxdlkjpssmt2k45qkvnqjr",\ "totalPrice": {\ "currency": "BTC",\ "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",\ "price": "0.00079968",\ "satPrice": "79968",\ "usdPrice": "49.54137552"\ },\ "txHash": "6ef9a11965cd8771a383f6447a5cdf438832368c86a46fa465aee1cd59cc4ad7",\ "typeName": "SALE",\ "unitPrice": {\ "currency": "BTC",\ "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",\ "price": "0.000000238",\ "satPrice": "23.8",\ "usdPrice": "0.014744457"\ }\ }\ ], "cursor": "MTMyMjM3MTEwNTQyMzM2MTE=", "hasNext": true }, "msg": "" } [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) [获取热门合集](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-popular-collections) [获取钱包资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-asset) --- # 智能合约 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) 智能合约 智能合约[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract#%E6%99%BA%E8%83%BD%E5%90%88%E7%BA%A6) ========================================================================================================================== 欧易 DEX 限价单 合约地址 ### DEX 限价单合约地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract#dex-%E9%99%90%E4%BB%B7%E5%8D%95%E5%90%88%E7%BA%A6%E5%9C%B0%E5%9D%80) 用于限价单签名交易的欧易 DEX router 地址 | 链名称 | DEX router 合约地址 | | --- | --- | | Ethereum | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | | Optimism | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | | Polygon | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | | BNB Chain | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | | OKC | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | | Avalanche C | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | | Fantom | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | | Arbitrum | 0x2ae8947FB81f0AAd5955Baeff9Dcc7779A3e49F2 | ### 币种授权合约地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract#%E5%B8%81%E7%A7%8D%E6%8E%88%E6%9D%83%E5%90%88%E7%BA%A6%E5%9C%B0%E5%9D%80) 用于 ERC-20 代币授权的合约地址 | 链名称 | 授权合约地址 | | --- | --- | | Ethereum | 0x40aA958dd87FC8305b97f2BA922CDdCa374bcD7f | | Optimism | 0x68D6B739D2020067D1e2F713b999dA97E4d54812 | | Polygon | 0x3B86917369B83a6892f553609F3c2F439C184e31 | | BNB Chain | 0x2c34A2Fb1d0b4f55de51E1d0bDEfaDDce6b7cDD6 | | OKC | 0x70cBb871E8f30Fc8Ce23609E9E0Ea87B6b222F58 | | Avalanche C | 0x40aA958dd87FC8305b97f2BA922CDdCa374bcD7f | | Fantom | 0x70cBb871E8f30Fc8Ce23609E9E0Ea87B6b222F58 | | Arbitrum | 0x70cBb871E8f30Fc8Ce23609E9E0Ea87B6b222F58 | [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) --- # 获取 Ordinals 交易历史 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) 获取 Ordinals 交易历史 获取 Ordinals 交易历史[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities#%E8%8E%B7%E5%8F%96-ordinals-%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2) =========================================================================================================================================================================== 该接口用于返回某个合集下所有成交的记录，包括交易 From 和 To 地址、交易时间和交易价格等。默认按照成交时间倒序。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/ordinals/trade-history` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 是 | 合集 slug 名称，即合集的唯一标识 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 10，最大 100）。每页返回最多交易历史的条数 | | sort | String | 否 | 排序规则：交易历史默认按时间倒序 `desc` 排序，可选正序 `asc` | | isBrc20 | Boolean | 否 | 获取全部 BTC NFT 或 Brc20 合集的交易历史，默认返回 BRC-20 。 | | orderSourceList | Integer\[\] | 否 | 获取某些平台的订单，请填入代号，如\[34,54\]（34:OKX 54:Magic Eden 55:OrdinalsWallet 57:Unisat ）。 | | tradeWalletAddress | String | 否 | 交易涉及的钱包地址 | | type | String | 否 | 交易类型，多个以‘,’分割。默认返回成交数据（SALE、LIST、TRANSFER、CANCEL\_LIST、UPDATE\_PRICE） | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个 [Ordinals 交易历史模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model.html#ordinals%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | fromAddress | String | 交易 From 地址 | | inscriptionId | String | 铭文编号 | | price | String | 交易价格，BTC 计价 | | timestamp | Long | 交易时间戳 | | toAddress | String | 交易 To 地址 | | unitPrice | String | 订单单价，BTC 计价 | | amount | String | 订单中的铭文数量 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT | | orderSource | Integer | 订单来源 | | orderSourceName | String | 订单来源名称 | | type | String | 交易类型 | [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X POST "https://web3.okx.com/api/v5/mktplace/nft/ordinals/trade-history" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "slug=xxx" \ -d "limit=1" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "MTcwMTE1NTM5MDo5OTZkYzdmMjljMzM1ODJhZjEwNDhjN2ZlMDgyZTU4Y2NhMTQ0ZDA3MzY0YTdkODc4NjUyYjhkM2ZhNGI2MTc3LTAtMjMzNTc5NTYzMDUxOTUxMjI=", "data": [\ {\ "amount": "10000000000",\ "fromAddress": "bc1q8nvhsrn7k7ltp2p4qm65wd7yxgypv0rvlam2h9",\ "inscriptionId": "0bd89dfef32761d8465055bbf4ccfcdac8bbd56d28032a01833c8b41ff3025b1i0",\ "isBrc20": true,\ "price": "0.03698",\ "slug": "sats",\ "timestamp": 1701155390,\ "toAddress": "bc1phlcxss2jumzm5rskhcfnzpxnsg8d7jn24h97umk7qceal55k600spaczp4",\ "unitPrice": "0.000000000003698",\ "orderSource": 34,\ "orderSourceName": "okx",\ "type": "SALE"\ }\ ] }, "msg": "" } [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) --- # 与不同类型合约的交互 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 与不同类型合约的交互 与不同类型合约的交互[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#%E4%B8%8E%E4%B8%8D%E5%90%8C%E7%B1%BB%E5%9E%8B%E5%90%88%E7%BA%A6%E7%9A%84%E4%BA%A4%E4%BA%92) =============================================================================================================================================================================== 订单种类主要由欧易聚合器合约和欧易自营市场合约构成。 欧易聚合器合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#%E6%AC%A7%E6%98%93%E8%81%9A%E5%90%88%E5%99%A8%E5%90%88%E7%BA%A6) ------------------------------------------------------------------------------------------------------------------------------------------------- 欧易聚合器的 API 是 `trade`，该接口封装了调用其他市场合约所需要的 calldata 数据。 function tradeV3( MarketRegistry.TradeDetails[] calldata tradeDetails, AggregatorParamV3[] calldata aggregatorParam, bool isAtomic ) external payable nonReentrant **MarketRegistry** `MarketRegistry` 是注册合约，聚合器支持的所有其他市场合约都需在此合约中注册。 struct TradeDetails { uint256 marketId; uint256 value; bytes32 orderHash; bytes tradeData; } | **参数名称** | **描述** | | --- | --- | | marketId | 市场自定义id | | value | 支付原生币的数量，例如ETH | | orderHash | 订单的哈希值 | | tradeData | 在其他市场实际执行交易的calldata数据，参考使用 Marketplace API 章节。 | **AggregatorParamV3** struct AggregatorParamV3 { uint256 actionType; uint256 payAmount; address payToken; address tokenAddress; uint256 tokenId; uint256 amount; uint256 tradeType; bytes extraData; } | **参数名称** | **描述** | | --- | --- | | actionType | 操作类型，目前仅支持 Seaport`1`: `_SEAPORT_BUY_ETH``2`: `_SEAPORT_BUY_ERC20``3`: \_`SEAPORT_ACCEPT` | | payAmount | 用于订单支付的 ERC20 Token数量 | | payToken | 用于订单支付的 ERC20 Token address | | tokenAddress | ERC721/ERC1155 的 Token address | | tokenId | tokenId | | amount | token 数量 | | tradeType | `0`: `NATIVE`, // ETH on mainnet, MATIC on polygon`1`: `ERC721`,`2`: `ERC1155`,`3`: `ERC721_WITH_CRITERIA`,`4`: `ERC1155_WITH_CRITERIA`,`5`: `ERC20` | | extraData | 扩展数据: address、address、address（订单的maker、订单的taker、统一授权地址） | **isAtomic** `isAtomic` 设置为 true 是指在批量执行订单时有任何订单执行失败将会触发 revert，设置为 false 则不触发 revert 欧易自营市场合约[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#%E6%AC%A7%E6%98%93%E8%87%AA%E8%90%A5%E5%B8%82%E5%9C%BA%E5%90%88%E7%BA%A6) ----------------------------------------------------------------------------------------------------------------------------------------------------------- ### 1\. 一口价挂单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#1.-%E4%B8%80%E5%8F%A3%E4%BB%B7%E6%8C%82%E5%8D%95) 一口价挂单是指挂出 NFT 等待买家购买，挂单时生成订单并进行签名，参考[创建挂单部分](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) 章节。 ### 2\. 执行订单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#2.-%E6%89%A7%E8%A1%8C%E8%AE%A2%E5%8D%95) 支持 _**fulfillBasicOrder**_ 和 _**fulfillAdvancedOrder**_ 两种接口。 **2.1 fulfillBasicOrder** function fulfillBasicOrder(BasicOrderParameters calldata parameters) external payable override returns (bool fulfilled); fulfillBasicOrder 接口的参数如下： struct BasicOrderParameters { address considerationToken; uint256 considerationIdentifier; uint256 considerationAmount; address payable offerer; address zone; address offerToken; uint256 offerIdentifier; uint256 offerAmount; BasicOrderType basicOrderType; uint256 startTime; uint256 endTime; bytes32 zoneHash; uint256 salt; bytes32 offererConduitKey; bytes32 fulfillerConduitKey; uint256 totalOriginalAdditionalRecipients; AdditionalRecipient[] additionalRecipients; bytes signature; } `considerationToken`：竞价盘 token 所对应的标的物地址 `considerationIdentifier`：竞价盘 token 所对应的 id `considerationAmount`：竞价盘 token 所对应的数量 `offerer`：该报价者的账户地址 `zone`：订单所对应的 zone `offerToken`：该报价 token 所对应的地址 `offerIdentifier`：该报价 token 所对应的 id `offerAmount`：该报价 token 所对应的数量 `basicOrderType`：订单类型 `startTime`：订单生效时间 `endTime`：订单失效时间 `zoneHash`：传递给 zone 的哈希值 `salt`：订单随机熵源 `offererConduitKey`：订单报价者的 ConduitKey `fulfillerConduitKey`：订单执行者的 ConduitKey `totalOriginalAdditionalRecipients`：竞价盘 token 接收者所对应的接收地址数量 `additionalRecipients`：额外 token 的接收方 `signature`：交易执行者的签名 enum BasicOrderType { // 0: no partial fills, anyone can execute ETH_TO_ERC721_FULL_OPEN, // 1: partial fills supported, anyone can execute ETH_TO_ERC721_PARTIAL_OPEN, // 2: no partial fills, only offerer or zone can execute ETH_TO_ERC721_FULL_RESTRICTED, // 3: partial fills supported, only offerer or zone can execute ETH_TO_ERC721_PARTIAL_RESTRICTED, // 4: no partial fills, anyone can execute ETH_TO_ERC1155_FULL_OPEN, // 5: partial fills supported, anyone can execute ETH_TO_ERC1155_PARTIAL_OPEN, // 6: no partial fills, only offerer or zone can execute ETH_TO_ERC1155_FULL_RESTRICTED, // 7: partial fills supported, only offerer or zone can execute ETH_TO_ERC1155_PARTIAL_RESTRICTED, // 8: no partial fills, anyone can execute ERC20_TO_ERC721_FULL_OPEN, // 9: partial fills supported, anyone can execute ERC20_TO_ERC721_PARTIAL_OPEN, // 10: no partial fills, only offerer or zone can execute ERC20_TO_ERC721_FULL_RESTRICTED, // 11: partial fills supported, only offerer or zone can execute ERC20_TO_ERC721_PARTIAL_RESTRICTED, // 12: no partial fills, anyone can execute ERC20_TO_ERC1155_FULL_OPEN, // 13: partial fills supported, anyone can execute ERC20_TO_ERC1155_PARTIAL_OPEN, // 14: no partial fills, only offerer or zone can execute ERC20_TO_ERC1155_FULL_RESTRICTED, // 15: partial fills supported, only offerer or zone can execute ERC20_TO_ERC1155_PARTIAL_RESTRICTED, // 16: no partial fills, anyone can execute ERC721_TO_ERC20_FULL_OPEN, // 17: partial fills supported, anyone can execute ERC721_TO_ERC20_PARTIAL_OPEN, // 18: no partial fills, only offerer or zone can execute ERC721_TO_ERC20_FULL_RESTRICTED, // 19: partial fills supported, only offerer or zone can execute ERC721_TO_ERC20_PARTIAL_RESTRICTED, // 20: no partial fills, anyone can execute ERC1155_TO_ERC20_FULL_OPEN, // 21: partial fills supported, anyone can execute ERC1155_TO_ERC20_PARTIAL_OPEN, // 22: no partial fills, only offerer or zone can execute ERC1155_TO_ERC20_FULL_RESTRICTED, // 23: partial fills supported, only offerer or zone can execute ERC1155_TO_ERC20_PARTIAL_RESTRICTED } **2.2 fulfillAdvancedOrder** function fulfillAdvancedOrder( AdvancedOrder calldata advancedOrder, CriteriaResolver[] calldata criteriaResolvers, bytes32 fulfillerConduitKey address recipient ) external payable override returns (bool fulfilled) 其中，参数 `fulfillerConduitKey`、`CriteriaResolver` 和 `AdvancedOrder` 的具体解析如下： * **fulfillerConduitKey**：吃单者的 ConduitKey * **recipient**：指定 token 的接收者地址，如未设置默认为 msg.sender * **CriteriaResolver**：用于验证 merkle 路径等参数是否满足限制条件的条件解析器 struct CriteriaResolver { uint256 orderIndex; Side side; uint256 index; uint256 identifier; bytes32[] criteriaProof; } `orderIndex`：明确多个订单中的具体某一订单 `side`：指报价者或其对手盘 `index`：订单 OfferItem 或 ConsiderationItem 中的索引值 `identifier`：订单交易所对应的 Token id `criteriaProof`：默克尔证明 * **Advanced Order**：订单参数 struct AdvancedOrder { OrderParameters parameters; uint120 numerator; uint120 denominator; bytes signature; bytes extraData; } `numerator`：订单部分成交中的分子 `denominator`：订单部分成交中的分母 `signature`：订单签名 `parameters`：订单参数，具体如下 struct OrderParameters { address offerer; address zone; OfferItem[] offer; ConsiderationItem[] consideration; OrderType orderType; uint256 startTime; uint256 endTime; bytes32 zoneHash; uint256 salt; bytes32 conduitKey; uint256 totalOriginalConsiderationItems; } `offerer`：挂单者 `offer`：该报价订单标的资产组合 `Consideration`：该报价单对手盘标的资产组合 `zone`：能够撤单以及可限制任意一方吃受限订单的账户地址 `orderType`：订单类型，支持开放、受限、全部成交、部分成交的两两组合，开放订单任何操作者均可执行，受限订单是只有 offerer 或订单的 zone 方可执行 `startTime`：订单生效时间 `endTime`：订单过期时间 `zoneHash`：用于验证受限订单的哈希值，zone 可以决定是否使用该哈希值 `salt`：订单随机熵源 `conduitKey`：是一个 byte32 类型的值，conduitKey 所对应的 conduit 是一个合约，该合约可代表订单报价者执行代币转移 `totalOriginalConsiderationItems`：报价单对手盘标的资产的数量，这个参数是必须定义的，因为调用者可能会增加额外标的资产 * **OfferItem** struct OfferItem { ItemType itemType; address token; uint256 identifierOrCriteria; uint256 startAmount; uint256 endAmount; } `token`：该被报价的 token 所对应的地址 `identifierOrCriteria`：该数值可能是 0，单个 token id 的值或多个 token ids 的 merkle root `startAmount`：初始数量 `endAmount`：结束数量，价格固定的订单 startAmount 和 endAmount 是相等的，但在拍卖时 endAmount 则随着时间的推移大于或小于 startAmount 订单类型用 **ItemType** 表示 enum ItemType { // 0: ETH on mainnet, MATIC on polygon, etc. NATIVE, // 1: ERC20 items (ERC777 and ERC20 analogues could also technically work) ERC20, // 2: ERC721 items ERC721, // 3: ERC1155 items ERC1155, // 4: ERC721 items where a number of tokenIds are supported ERC721_WITH_CRITERIA, // 5: ERC1155 items where a number of ids are supported ERC1155_WITH_CRITERIA } `NATIVE`：主链上的 token `ERC721_WITH_CRITERIA`：符合 ERC-721 标准铸造的多个 NFT，可与 identifierOrCriteria 配合使用 `ERC1155_WITH_CRITERIA`：符合 ERC-1155 标准铸造的多个 NFT，可与 identifierOrCriteria 配合使用 struct ConsiderationItem { ItemType itemType; address token; uint256 identifierOrCriteria; uint256 startAmount; uint256 endAmount; address payable recipient; } `ConsiderationItem` 和 `OfferItem` 里面所包含的各个项目基本相同，ConsiderationItem 增加了 recipient 字段，用于指出能从订单执行中获得 token 的地址 ### 3\. 下架[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#3.-%E4%B8%8B%E6%9E%B6) 支持批量撤单，仅有 `offerer` 和 `zone` 可进行撤单操作 function cancel(OrderComponents[] calldata orders) external override returns (bool cancelled); OrderComponents 的数据结构： struct OrderComponents { address offerer; address zone; OfferItem[] offer; ConsiderationItem[] consideration; OrderType orderType; uint256 startTime; uint256 endTime; bytes32 zoneHash; uint256 salt; bytes32 conduitKey; uint256 counter; } `OrderComponents` 与 `OrderParameters` 的参数基本相同，`counter` 是交易量计数 [订单相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) 目录 [欧易聚合器合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#%E6%AC%A7%E6%98%93%E8%81%9A%E5%90%88%E5%99%A8%E5%90%88%E7%BA%A6) [欧易自营市场合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types#%E6%AC%A7%E6%98%93%E8%87%AA%E8%90%A5%E5%B8%82%E5%9C%BA%E5%90%88%E7%BA%A6) --- # 获取 Ordinals 合集列表 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) 获取 Ordinals 合集列表 获取 Ordinals 合集列表[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list#%E8%8E%B7%E5%8F%96-ordinals-%E5%90%88%E9%9B%86%E5%88%97%E8%A1%A8) ================================================================================================================================================================================ 该接口用于获取全部 BTC NFT 和 Brc20 合集的列表 ，包括合集唯一标识 slug、铭文编号范围、交易额以及地板价。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/ordinals/collections` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 否 | 合集 slug 名称，即合集的唯一标识，参数不为空则代表查询指定合集 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 100，最大 300）。返回最大的合集数 | | isBrc20 | Boolean | 否 | 获取全部 BTC NFT 或 Brc20 合集的列表，默认为 Brc20 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个 [Ordinals 合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model.html#ordinals%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | slug | String | 合集 slug 名称，即合集的唯一标识 | | totalVolume | String | 合集总交易额，BTC 计价 | | floorPrice | String | 合集地板价，BTC 计价 | | inscriptionNumRange | String | 合集铭文编号范围 | | volume24h | String | 合集24小时交易额，BTC 计价 | | isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 BTC NFT | [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/ordinals/collections" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "limit=1" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "", "data": [\ {\ "floorPrice": "0.00065",\ "inscriptionNumRange": "#10423123-#44607771",\ "isBrc20": false,\ "slug": "bitmap-4",\ "totalVolume": "3038.695704830937",\ "volume24h": "31.6151456383466366"\ }\ ] }, "msg": "" } [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) --- # 查询铭文交易 | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) 查询铭文交易 查询铭文交易[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash#%E6%9F%A5%E8%AF%A2%E9%93%AD%E6%96%87%E4%BA%A4%E6%98%93) ====================================================================================================================================================================== 根据交易哈希查询代币铭文交易明细 * 支持查询 BTC 链 的 Runes、BRC-20、SRC-20、ARC-20、Ordinals NFT 的交易明细。 * 支持 Fractal Bitcoin 链的 BRC-20 的交易明细。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/post-transaction/inscription-transaction-detail-by-txhash` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | txHash | String | Yes | 交易哈希 | | protocol | String | Yes | 协议类型
`1`:BRC-20
`2`:ARC-20
`3`:Runes
`4`:Ordinals NFT
`5`:SRC-20
不传默认为 BRC-20 | | cursor | String | No | 游标 | | limit | String | No | 返回条数，默认返回最近的 20 条，最多 100 条 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | transactionDetails | Array | 交易详情 | | \>txStatus | String | 交易状态
成功`success`
失败：`fail`
暂不支持 pending 交易 | | \>from | String | 发送方，多签地址，逗号分隔 | | \>to | String | 接收方，多签地址，逗号分隔 | | \>eventType | String | 交易类型
BRC-20 ：`deploy`、`mint`、`inscribeTransfer`、`transfer`
Runes：`Etch`、`Mintoutput`、`Burninput`、`Mint`
ARC-20：`atomical-create-ft`、`ft-color-split`、`ft-color-regular`、`distributed-mint`
SRC-20：`mint`、`transfer`、`deploy`
Ordinals NFT：`mint`、`transfer` | | \>protocol | String | 协议类型
`1`:BRC-20
`2`:ARC-20
`3`:Runes
`4`:ordi\_nft
`5`:SRC-20 | | \>txHash | String | 交易哈希 | | \>blockHash | String | 区块哈希 | | \>height | String | 交易发生的区块高度 | | \>txTime | String | 交易时间；Unix 时间戳的毫秒数格式，如 1597026383085 | | \>amount | String | 交易数量 | | \>symbol | String | 代币名称 | | \>tokenInscriptionId | String | 铭文代币的铭文 ID
对于 Runes 符文，返回 `Rune ID`
对于 BRC-20 代币，返回代币的`Inscription ID`，通用代币的唯一标识
对于 ARC-20 代币，返回代币的 `Atomical ID`
其他铭文代币该字段返回空 | | \>inscriptionNumber | String | 每一次交易中涉及到的铭文编号 | | \>outputIndex | String | Runes 代币转账对应的 UTXO 索引，仅适用于 Runes 代币 | | cursor | String | 游标 | [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/post-transaction/inscription-transaction-detail-by-txhash?chainIndex=0&limit=10&txHash=18ccb1bc8c931cf4253065c2a5612fed7bd0eabd0a34139485b34305bcfc2b18&protocol=2' --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "cursor": "",\ "transactionDetails": [\ {\ "txHash": "18ccb1bc8c931cf4253065c2a5612fed7bd0eabd0a34139485b34305bcfc2b18",\ "blockHash": "00000000000000000000bcf4a44104b9cc54dc3a6e3b8a1007d73077e4fe224b",\ "height": "854743",\ "txTime": "1722394665000",\ "from": "",\ "to": "bc1pltwpza8fz00aqjf0s6z5pvhzrtwpj5nk75m5x7st7rqnq6tkqa2skhcs40",\ "amount": "1454",\ "symbol": "quark",\ "eventType": "ft-color-regular",\ "tokenInscriptionId": "9125f03bcf9325f6071762b9aee00b461a0b43ed157c336e2e89e07f47ea6f66i0",\ "protocol": "2",\ "txStatus": "success",\ "inscriptionId": "",\ "inscriptionNumber": "",\ "outputIndex": ""\ },\ {\ "txHash": "18ccb1bc8c931cf4253065c2a5612fed7bd0eabd0a34139485b34305bcfc2b18",\ "blockHash": "00000000000000000000bcf4a44104b9cc54dc3a6e3b8a1007d73077e4fe224b",\ "height": "854743",\ "txTime": "1722394665000",\ "from": "",\ "to": "bc1pm7fxkgcrqghf2rtxdw4hupvdpqkped7azyrh2mukedrw2p0cj3hsxt8ph3",\ "amount": "546",\ "symbol": "quark",\ "eventType": "ft-color-regular",\ "tokenInscriptionId": "9125f03bcf9325f6071762b9aee00b461a0b43ed157c336e2e89e07f47ea6f66i0",\ "protocol": "2",\ "txStatus": "success",\ "inscriptionId": "",\ "inscriptionNumber": "",\ "outputIndex": ""\ }\ ]\ }\ ] } [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) --- # 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) 交易历史 交易历史[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api#%E4%BA%A4%E6%98%93%E5%8E%86%E5%8F%B2) ========================================================================================================================================= 交易历史板块，支持查询交易摘要和交易详情，包含铭文交易。交易仅保留半年 [地址维度查询\ \ 查询当前地址下的交易历史数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [账户维度查询\ \ 查询当前账户下的交易历史数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询特定 Tx\ \ 根据 txHash 查询某个交易的详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [查询铭文交易\ \ 根据 txHash 查询铭文交易详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) --- # 申购流程 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) [申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) [赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) [领取奖励流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) 申购流程 申购流程[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E7%94%B3%E8%B4%AD%E6%B5%81%E7%A8%8B) ============================================================================================================================= 对于申购，流程指引见[概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) 中的申购流程部分。 1\. 设置你的环境[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) -------------------------------------------------------------------------------------------------------------------------------------------------------- 设置环境，详情见[导入必要的 Node.js 库](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#1.-%E5%AF%BC%E5%85%A5%E5%BF%85%E8%A6%81%E7%9A%84-node.js-%E5%BA%93) 。 2\. 搜索平台信息并获取投资品详情[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#2.-%E6%90%9C%E7%B4%A2%E5%B9%B3%E5%8F%B0%E4%BF%A1%E6%81%AF%E5%B9%B6%E8%8E%B7%E5%8F%96%E6%8A%95%E8%B5%84%E5%93%81%E8%AF%A6%E6%83%85) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### 2.1 搜索协议下投资品列表概要信息[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#2.1-%E6%90%9C%E7%B4%A2%E5%8D%8F%E8%AE%AE%E4%B8%8B%E6%8A%95%E8%B5%84%E5%93%81%E5%88%97%E8%A1%A8%E6%A6%82%E8%A6%81%E4%BF%A1%E6%81%AF) 以下是一个 Node.js 请求的示例。接口信息看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义查询授权额度的参数。 const getProtocolListParam = { platformName: '', platformId: '' }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getProtocolListRequestUrl = (api, queryParams) => { const path = api + '?' + new URLSearchParams(queryParams).toString(); return { apiRequestUrl: exploreBaseUrl + path, path: exploreBasePath + path, }; }; const getProtocolListData = async () => { const { apiRequestUrl, path } = getProtocolListRequestUrl( '/protocol/list', getProtocolListParam ); return fetch(apiRequestUrl, { method: 'GET', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) 提示 获取结果。如果需要跳转到投资品详情网页，请使用结果中的 investmentPageUrlPattern 的值并在占位符填加 investmentId 对应值组成 URL；如果要查询投资品详情 API，用 investmentApiUrlPattern 的值拼接 investmentId 对应值组成 URL。 async function someFunction() { const { data: protocolListData } = await getProtocolListData(); console.log(JSON.stringify(protocolListData)); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": [\ {\ "platformId": 294,\ "platformName": "SpaceFi",\ "platformWebSite": "https://spacefi.io/",\ "investmentApiUrlPattern": "https://web3.okx.com/api/v5/defi/explore/product/detail?investmentId=",\ "investmentPageUrlPattern": "https://web3.okx.com/cn/web3/defi/detail/${investmentId}",\ "platformMinInfos":\ [\ {\ "investmentId": "21010",\ "protocolId": "207",\ "network": "ZKSYNC",\ "chainId": "1"\ },\ {\ "investmentId": "21011",\ "protocolId": "207",\ "network": "ZKSYNC",\ "chainId": "1"\ }\ ]\ }\ ] } ### 2.2 搜索投资品详情信息[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#2.2-%E6%90%9C%E7%B4%A2%E6%8A%95%E8%B5%84%E5%93%81%E8%AF%A6%E6%83%85%E4%BF%A1%E6%81%AF) 你可以通过上一步获得的 investmentApiUrlPattern 和 investmentId 属性来组成投资品详情的 URL。接口信息参照[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 定义查询授权额度的参数。 const getProductDetailParam = { investmentId: '21010', investmentCategory: '' }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getProductDetailRequestUrl = (api, queryParams) => { const path = api + '?' + new URLSearchParams(queryParams).toString(); return { apiRequestUrl: exploreBaseUrl + path, path: exploreBasePath + path, }; }; const getProductDetailData = async () => { const { apiRequestUrl, path } = getProductDetailRequestUrl( '/product/detail', getProductDetailParam ); return fetch(apiRequestUrl, { method: 'GET', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: productDetailData } = await getProductDetailData(); console.log(JSON.stringify(productDetailData)); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "investmentId": "21010", "investmentName": "USDC-ETH", "chainId": "324", "rate": "0.06340", "investType": "2", "platformName": "SpaceFi", "platformId": "491", "analysisPlatformId": "294", "poolVersion": "1", "rateType": "1", "tvl": "4464444.45647", "underlyingToken": [\ {\ "tokenSymbol": "USDC",\ "tokenAddress": "0x3355df6d4c9c3035724fd0e3914de96a5a83aaf4",\ "isBaseToken": false\ },\ {\ "tokenSymbol": "ERA_ETH",\ "tokenAddress": "0x0000000000000000000000000000000000000000",\ "isBaseToken": true\ }\ ], "isInvestable": true, "earnedToken": [\ {\ "tokenSymbol": "USDC",\ "tokenAddress": "0x3355df6d4c9c3035724fd0e3914de96a5a83aaf4",\ "isBaseToken": false\ },\ {\ "tokenSymbol": "ERA_ETH",\ "tokenAddress": "0x0000000000000000000000000000000000000000",\ "isBaseToken": true\ }\ ], "lpToken": [\ {\ "tokenSymbol": "SLP",\ "tokenAddress": "0xd0ce094412898760c2a5e37abec39b0e785b45ae",\ "isBaseToken": false\ }\ ], "subscriptionMethod": "2", "redeemMethod": "2" } } 3\. 查询投资预估收益信息计算[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#3.-%E6%9F%A5%E8%AF%A2%E6%8A%95%E8%B5%84%E9%A2%84%E4%BC%B0%E6%94%B6%E7%9B%8A%E4%BF%A1%E6%81%AF%E8%AE%A1%E7%AE%97) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 投资产品的有效数据。你可以通过输入想要投资的金额，得到你预估的投资收益信息。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义计算投资申购收益的参数。 const getSubscribeInfoBody = { inputAmount: "1", inputTokenAddress: "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", investmentId: "21200", address: "0x7f****da", investmentType: "0", tokenDecimal: "18", isSingle: false }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getSubscribeInfoData = async () => { return fetch(calculatorBaseUrl + '/subscribe-info', { method: 'POST', headers: headersParams, body: JSON.stringify(getSubscribeInfoBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: subscribeInfoData } = await getSubscribeInfoData(); console.log(subscribeInfoData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "investWithTokenList": [\ {\ "tokenSymbol": "CORE",\ "tokenName": "Core",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "chainId": "1116",\ "tokenPrecision": "18",\ "isBaseToken": true,\ "coinAmount": "1",\ "currencyAmount": "0.4918"\ }\ ], "gainsTokenList": [\ {\ "tokenSymbol": "CORE",\ "tokenName": "Core",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "tokenPrecision": "18",\ "coinAmount": "0.00069321843585011",\ "dataType": "0"\ }\ ], "approveStatusList": [\ {\ "tokenSymbol": "CORE",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "chainId": "1116",\ "tokenPrecision": "18",\ "isNeedApprove": false,\ "approveAddress": "0x0000000000000000000000000000000000001007",\ "orderType": "3"\ }\ ], "isSwapInvest": false, "estimateGasFee": "99343", "isAllowSubscribe": true, "validatorName": "OKXEarn" } } 4\. 生成用于申购交易的调用数据[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#4.-%E7%94%9F%E6%88%90%E7%94%A8%E4%BA%8E%E7%94%B3%E8%B4%AD%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ 我们进行认购的流程如下： ### 4.1 申购授权[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#4.1-%E7%94%B3%E8%B4%AD%E6%8E%88%E6%9D%83) 以下是一个 Node.js 请求的示例。接口信息看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 定义授权申购额度的参数。 const userInputList = [\ {\ "chainId": "56",\ "coinAmount": "10",\ "tokenAddress": "0x526a913a7a4518aa2abc3dcd3c46a9c73f40f94a"\ }\ ]; const getTransactionAuthorizationBody = { address: '0x7f****da', type: '3', investmentId: '6925', userInputList: userInputList }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getTransactionAuthorizationData = async () => { return fetch(transactionBaseUrl + '/authorization', { method: 'POST', headers: headersParams, body: JSON.stringify(getTransactionAuthorizationBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: transactionAuthorizationData } = await getTransactionAuthorizationData(); console.log(transactionAuthorizationData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "dataList": [\ {\ "from": "0x7f4****da",\ "to": "0x52****4a",\ "value": "0x0",\ "serializedData": "0x095ea7b30000000000000000000000002c34a2fb1d0b4f55de51e1d0bdefaddce6b7cdd60000000000000000000000000000000000000000000000008ac7230489e80000",\ "originalData": "{\"methodDefine\":\"approve(address,uint256)\",\"methodId\":\"0x095ea7b3\",\"methodType\":\"METHOD_ID\",\"params\":{\"params\":[\"0x2c34a2fb1d0b4f55de51e1d0bdefaddce6b7cdd6\",\"10000000000000000000\"]},\"useAdapter\":false}",\ "signatureData": "1bca0efbd1c809de94cdd8c924329c7ac79a4d346742de61925e8494f2c84c446bd3cf42b56d690c85ff513beadf46cd18f4e3e74845a92c48451584615f749d1c"\ }\ ] } } ### 4.2 申购交易[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#4.2-%E7%94%B3%E8%B4%AD%E4%BA%A4%E6%98%93) 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 定义查询申购投资品的参数。 const userInputList = [\ {\ "coinAmount": "0.6"\ }\ ]; const expectOutputList = [\ {\ "coinAmount": "0.6"\ }\ ]; const getTransactionSubscriptionBody = { address: '0x7f****da', investmentId: '6925', userInputList: userInputList, expectOutputList: expectOutputList }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getTransactionSubscriptionData = async () => { return fetch(transactionBaseUrl+'/subscription', { method: 'post', headers: headersParams, body: JSON.stringify(getTransactionSubscriptionBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: transactionSubscriptionData } = await getTransactionSubscriptionData(); console.log(transactionSubscriptionData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "dataList": [\ {\ "from": "0x7f****da",\ "to": "0x72****d2",\ "value": "0x0",\ "serializedData": "0x016cba5f00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000526a913a7a4518aa2abc3dcd3c46a9c73f40f94a0000000000000000000000000000000000000000000000000853a0d2313c00000000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da9400000000000000000000000000000000000000000000000000000000000000010000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce600000000000000000000000000000000000000000000000006f05b59d3b20000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da94000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e4c41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f700000000000000000000000000000000000000000000000000000000",\ "originalDataClass": "OriginalDataEntrance",\ "originalData": "{\"hexCallData\":\"0x016cba5f00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000526a913a7a4518aa2abc3dcd3c46a9c73f40f94a0000000000000000000000000000000000000000000000000853a0d2313c00000000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da9400000000000000000000000000000000000000000000000000000000000000010000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce600000000000000000000000000000000000000000000000006f05b59d3b20000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da94000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e4c41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f700000000000000000000000000000000000000000000000000000000\",\"methodDefine\":\"{\\n\\t\\\"inputs\\\": [{\\n\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\\"internalType\\\": \\\"struct TokenInInfo\\\",\\n\\t\\t\\t\\\"name\\\": \\\"tokenIn\\\",\\n\\t\\t\\t\\\"type\\\": \\\"tuple[]\\\",\\n\\t\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"token\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"uint256\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"amount\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"uint256\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"to\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}]\\n\\t\\t}, {\\n\\t\\t\\t\\\"internalType\\\": \\\"struct TokenAmount\\\",\\n\\t\\t\\t\\\"name\\\": \\\"tokenOut\\\",\\n\\t\\t\\t\\\"type\\\": \\\"tuple[]\\\",\\n\\t\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"token\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"uint256\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"amount\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"uint256\\\"\\n\\t\\t\\t}]\\n\\t\\t}],\\n\\t\\t\\\"internalType\\\": \\\"struct BaseRequest\\\",\\n\\t\\t\\\"name\\\": \\\"request\\\",\\n\\t\\t\\\"type\\\": \\\"tuple\\\"\\n\\t}, {\\n\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\\"name\\\": \\\"target\\\",\\n\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t}, {\\n\\t\\t\\t\\\"internalType\\\": \\\"bytes\\\",\\n\\t\\t\\t\\\"name\\\": \\\"callData\\\",\\n\\t\\t\\t\\\"type\\\": \\\"bytes\\\"\\n\\t\\t}],\\n\\t\\t\\\"internalType\\\": \\\"struct Call\\\",\\n\\t\\t\\\"name\\\": \\\"calls\\\",\\n\\t\\t\\\"type\\\": \\\"tuple[]\\\"\\n\\t}],\\n\\t\\\"name\\\": \\\"execute\\\",\\n\\t\\\"stateMutability\\\": \\\"payable\\\",\\n\\t\\\"type\\\": \\\"function\\\"\\n}\",\"methodId\":\"\",\"methodType\":\"ABI\",\"params\":{\"baseRequest\":{\"tokenIn\":[{\"amount\":600000000000000000,\"to\":\"0x5569e13b1ec4336d17e8f24d892a4a915fc5da94\",\"token\":\"0x526a913a7a4518aa2abc3dcd3c46a9c73f40f94a\"}],\"tokenOut\":[{\"amount\":500000000000000000,\"token\":\"0x4e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce6\"}]},\"operatorDataList\":[{\"adapterOperate\":true,\"call\":{\"calls\":\"xBo76AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAATjikrU8hCtWrssjyWYcGrotKHOYAAAAAAAAAAAAAAAB/Qp7e/4r8e7Oiz324MvyG9vqZ2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAbwW1nTsgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACb3\",\"callsAsString\":\"0xc41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f7\",\"target\":\"0x5569e13b1ec4336d17e8f24d892a4a915fc5da94\"},\"hexCallData\":\"0xc41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f7\",\"operateType\":\"DEPOSIT\",\"operatorMethodInfo\":{\"methodDefine\":\"{\\n\\t\\\"inputs\\\": [{\\n\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\\"name\\\": \\\"pool\\\",\\n\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t}, {\\n\\t\\t\\\"internalType\\\": \\\"struct TokenOutInfo\\\",\\n\\t\\t\\\"name\\\": \\\"tokenOut\\\",\\n\\t\\t\\\"type\\\": \\\"tuple\\\",\\n\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"token\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"toAddress\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t},\\n\\t\\t\\t{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"uint256\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"minAmount\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"uint256\\\"\\n\\t\\t\\t}\\n\\t\\t]\\n\\t}, {\\n\\t\\t\\\"internalType\\\": \\\"bytes\\\",\\n\\t\\t\\\"name\\\": \\\"data\\\",\\n\\t\\t\\\"type\\\": \\\"bytes\\\"\\n\\n\\t}],\\n\\t\\\"name\\\": \\\"deposit\\\",\\n\\t\\\"stateMutability\\\": \\\"payable\\\",\\n\\t\\\"type\\\": \\\"function\\\"\\n}\",\"params\":{\"data\":\"00000000000000000000000000000000000000000000000000000000000026f7\",\"pool\":\"0x0000000000000000000000000000000000000000\",\"tokenOut\":{\"amount\":500000000000000000,\"toAddress\":\"0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da\",\"token\":\"0x4e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce6\"}}},\"target\":\"0x5569e13b1ec4336d17e8f24d892a4a915fc5da94\"}]},\"useAdapter\":true}",\ "signatureData": "dbfe682a491b31141c99800913c9a052ee8dee122854cb0c459af85fff9f5d571aaf217b3bbbe10b141247bc0327357c3dde2874333f8a4c031d84d31a41ffec1c"\ }\ ] } } 5\. 签名和广播[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#5.-%E7%AD%BE%E5%90%8D%E5%92%8C%E5%B9%BF%E6%92%AD) ---------------------------------------------------------------------------------------------------------------------------------------------- 签名时可以直接使用第三步获得的 serializedData 作为 Call data，也可以由用户通过 originalData 自己拼装 Call data 进行签名广播。EVM 类投资品参考签名[示例](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E9%80%81%E4%BA%A4%E6%98%93) 。 [概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) [赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) 目录 [1\. 设置你的环境](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) [2\. 搜索平台信息并获取投资品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#2.-%E6%90%9C%E7%B4%A2%E5%B9%B3%E5%8F%B0%E4%BF%A1%E6%81%AF%E5%B9%B6%E8%8E%B7%E5%8F%96%E6%8A%95%E8%B5%84%E5%93%81%E8%AF%A6%E6%83%85) [3\. 查询投资预估收益信息计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#3.-%E6%9F%A5%E8%AF%A2%E6%8A%95%E8%B5%84%E9%A2%84%E4%BC%B0%E6%94%B6%E7%9B%8A%E4%BF%A1%E6%81%AF%E8%AE%A1%E7%AE%97) [4\. 生成用于申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#4.-%E7%94%9F%E6%88%90%E7%94%A8%E4%BA%8E%E7%94%B3%E8%B4%AD%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) [5\. 签名和广播](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow#5.-%E7%AD%BE%E5%90%8D%E5%92%8C%E5%B9%BF%E6%92%AD) --- # 已经接入的网络 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 已经接入的网络 已经接入的网络[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains#%E5%B7%B2%E7%BB%8F%E6%8E%A5%E5%85%A5%E7%9A%84%E7%BD%91%E7%BB%9C) =========================================================================================================================================================== 提示 网络和 chainId 关联关系，请前往 [网络 chainId 映射](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) 进行查看。 | 区块链网络 | 关键词 | | --- | --- | | Ethereum Mainnet | eth | | Polygon Mainnet | polygon | | Avalanche C-Chain | avax | | BNB Smart Chain Mainnet | bsc | | OKT Chain | oktc | | Arbitrum One | arbitrum | | Arbitrum Nova | arbitrum-nova | | OP Mainnet | optimism | | Klaytn Mainnet Cypress | klaytn | | zkSync Era Mainnet | zksync-era | | Base | base | | Linea | linea | | opBNB Mainnet | opbnb | | Polygon zkEVM | polygon-zkevm | | Scroll | scroll | | Manta Pacific Mainnet | manta-pacific | [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) --- # 领取奖励流程 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) [申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) [赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) [领取奖励流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) 领取奖励流程 领取奖励流程[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E9%A2%86%E5%8F%96%E5%A5%96%E5%8A%B1%E6%B5%81%E7%A8%8B) ========================================================================================================================================== 对于领取奖励，流程指引见[概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) 中的领取奖励金流程部分。 1\. 设置你的环境[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) ------------------------------------------------------------------------------------------------------------------------------------------------- 设置环境，详情见[导入必要的 Node.js 库](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#1.-%E5%AF%BC%E5%85%A5%E5%BF%85%E8%A6%81%E7%9A%84-node.js-%E5%BA%93) 。 2\. 搜索用户持仓[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#2.-%E6%90%9C%E7%B4%A2%E7%94%A8%E6%88%B7%E6%8C%81%E4%BB%93) ------------------------------------------------------------------------------------------------------------------------------------------------- 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义获取用户持仓的请求参数。 const domain = 'https://web3.okx.com'; const exploreBasePath = '/api/v5/defi/explore'; const transactionBasePath = '/api/v5/defi/transaction'; const userBasePath = '/api/v5/defi/user'; const calculatorBasePath = '/api/v5/defi/calculator'; const exploreBaseUrl = domain + exploreBasePath; // Explore API base url const transactionBaseUrl = domain + transactionBasePath; // Transaction API base url const userBaseUrl = domain + userBasePath; // User API base url const calculatorBaseUrl = domain + calculatorBasePath; // Calculator API base url const getUserAssetBody = { "address":"0x7f****da", "investmentId":"15299", "chainId":"137" }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getUserAssetData = async () => { return fetch(calculatorBaseUrl + '/asset-detail', { method: 'POST', headers: headersParams, body: JSON.stringify(getUserAssetBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: userAssetData } = await getUserAssetData(); console.log(userAssetData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": [\ {\ "investmentName": "MATIC earn MATIC",\ "investmentId": "15299",\ "investType": "5",\ "investName": "Stake",\ "assetsTokenList":\ [\ {\ "tokenSymbol": "MATIC",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "MATIC",\ "tokenPrecision": "18",\ "coinAmount": "0E-18",\ "currencyAmount": "0"\ }\ ],\ "rewardDefiTokenInfo":\ [\ {\ "baseDefiTokenInfos":\ [\ {\ "tokenSymbol": "MATIC",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "MATIC",\ "tokenPrecision": "18",\ "coinAmount": "10.907755587159277921",\ "currencyAmount": "8.3804286176144732267043",\ "buttonType": "3"\ }\ ],\ "buttonType": "0",\ "claimMode": "1",\ "rewardType": "1"\ }\ ],\ "totalValue": "8.3804286176144732267043"\ }\ ] } 3\. 搜索平台信息并获取投资品详情[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#3.-%E6%90%9C%E7%B4%A2%E5%B9%B3%E5%8F%B0%E4%BF%A1%E6%81%AF%E5%B9%B6%E8%8E%B7%E5%8F%96%E6%8A%95%E8%B5%84%E5%93%81%E8%AF%A6%E6%83%85) --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 定义查询投资品详情的参数。 const getProductDetailParam = { investmentId: '21010', investmentCategory: '' }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getProductDetailRequestUrl = (api, queryParams) => { const path = api + '?' + new URLSearchParams(queryParams).toString(); return { apiRequestUrl: exploreBaseUrl + path, path: exploreBasePath + path, }; }; const getProductDetailData = async () => { const { apiRequestUrl, path } = getProductDetailRequestUrl( '/product/detail', getProductDetailParam ); return fetch(apiRequestUrl, { method: 'GET', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: productDetailData } = await getProductDetailData(); console.log(productDetailData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "investmentId": "21010", "investmentName": "USDC-ETH", "chainId": "324", "rate": "0.06340", "investType": "2", "platformName": "SpaceFi", "platformId": "491", "analysisPlatformId": "294", "poolVersion": "1", "rateType": "1", "tvl": "4464444.45647", "underlyingToken": [\ {\ "tokenSymbol": "USDC",\ "tokenAddress": "0x3355df6d4c9c3035724fd0e3914de96a5a83aaf4",\ "isBaseToken": false\ },\ {\ "tokenSymbol": "ERA_ETH",\ "tokenAddress": "0x0000000000000000000000000000000000000000",\ "isBaseToken": true\ }\ ], "isInvestable": true, "earnedToken": [\ {\ "tokenSymbol": "USDC",\ "tokenAddress": "0x3355df6d4c9c3035724fd0e3914de96a5a83aaf4",\ "isBaseToken": false\ },\ {\ "tokenSymbol": "ERA_ETH",\ "tokenAddress": "0x0000000000000000000000000000000000000000",\ "isBaseToken": true\ }\ ], "lpToken": [\ {\ "tokenSymbol": "SLP",\ "tokenAddress": "0xd0ce094412898760c2a5e37abec39b0e785b45ae",\ "isBaseToken": false\ }\ ], "subscriptionMethod": "2", "redeemMethod": "2" } } 4\. 生成用于领取奖励金交易的调用数据[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#4.-%E7%94%9F%E6%88%90%E7%94%A8%E4%BA%8E%E9%A2%86%E5%8F%96%E5%A5%96%E5%8A%B1%E9%87%91%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 定义领取奖励金业务需要的参数。 const expectOutputList = [\ {\ "chainId": "56",\ "coinAmount": "10",\ "tokenAddress": "0x526a913a7a4518aa2abc3dcd3c46a9c73f40f94a"\ }\ ]; const getTransactionBonusBody = { address: "0x7f****da", expectOutputList: expectOutputList, investmentId: "21670", extra: "{\"callDataExtJson\":\"\",\"redeemCalldataExtInfo\":[],\"rewardAddress\":\"\"}" }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getTransactionBonusData = async () => { return fetch(transactionBaseUrl + '/bonus', { method: 'POST', headers: headersParams, body: JSON.stringify(getTransactionBonusBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: transactionBonusData } = await getTransactionBonusData(); console.log(transactionBonusData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "dataList": [\ {\ "callDataType": "CLAIM",\ "from": "0x7f****da",\ "to": "0xed****bd",\ "value": "0x3fdc04eea0dcf6",\ "serializedData": "0x9e4bdf3a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000",\ "originalData": "{\"callDataType\":\"CLAIM\",\"methodDefine\":\"getReward(address, bytes)\",\"methodId\":\"0x9e4bdf3a\",\"methodType\":\"METHOD_ID\",\"params\":{\"params\":[\"0x0000000000000000000000000000000000000000\",\"org.web3j.abi.datatypes.DynamicBytes@59dc08a\"]},\"useAdapter\":false}",\ "signatureData": "b19f75a8c211c752ff5c82aa130eccee229d16dd05d56874c7a9fd876c5d6d61500dc326ff0aa65b747bca2a2b5cd111e93b53deda73491d8eca97acf8cceb521c"\ }\ ] } } 5\. 签名和广播[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#5.-%E7%AD%BE%E5%90%8D%E5%92%8C%E5%B9%BF%E6%92%AD) --------------------------------------------------------------------------------------------------------------------------------------- 签名时可以直接使用第三步获得的 serializedData 作为 Call data ，也可以由用户通过 originalData 自己拼装 Call data 进行签名广播。EVM 类投资品参考签名[示例](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E9%80%81%E4%BA%A4%E6%98%93) 。 [赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) 目录 [1\. 设置你的环境](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) [2\. 搜索用户持仓](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#2.-%E6%90%9C%E7%B4%A2%E7%94%A8%E6%88%B7%E6%8C%81%E4%BB%93) [3\. 搜索平台信息并获取投资品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#3.-%E6%90%9C%E7%B4%A2%E5%B9%B3%E5%8F%B0%E4%BF%A1%E6%81%AF%E5%B9%B6%E8%8E%B7%E5%8F%96%E6%8A%95%E8%B5%84%E5%93%81%E8%AF%A6%E6%83%85) [4\. 生成用于领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#4.-%E7%94%9F%E6%88%90%E7%94%A8%E4%BA%8E%E9%A2%86%E5%8F%96%E5%A5%96%E5%8A%B1%E9%87%91%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) [5\. 签名和广播](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow#5.-%E7%AD%BE%E5%90%8D%E5%92%8C%E5%B9%BF%E6%92%AD) --- # 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) 交易 交易[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction#%E4%BA%A4%E6%98%93) ====================================================================================================== 描述：该 API 将在你开始使用时提供交易的调用数据。 [生成交易前授权的调用数据\ \ 获取交易前授权调用数据的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成申购交易的调用数据\ \ 获取申购交易调用数据的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成赎回交易的调用数据\ \ 获取赎回交易调用数据的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [生成领取奖励金交易的调用数据\ \ 获取领取奖励金交易调用数据的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) [查询赎回的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) --- # 资产 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [获取资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 资产 API 资产 API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api#%E8%B5%84%E4%BA%A7-api) ===================================================================================================== [获取资产列表\ \ 获取资产所有人在指定链下持有的 NFT 资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list) [获取 NFT 列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list) [获取资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list) --- # 赎回流程 | 快速开始 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) [申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) [赎回流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow) [领取奖励流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) 赎回流程 赎回流程[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E8%B5%8E%E5%9B%9E%E6%B5%81%E7%A8%8B) =========================================================================================================================== 对于赎回，流程指引见[概述](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-overview) 中的赎回流程部分。 1\. 设置你的环境[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) ------------------------------------------------------------------------------------------------------------------------------------------------------ 设置环境，详情见[导入必要的 Node.js 库](https://web3.okx.com/zh-hans/build/docs/waas/nodejs-environment#1.-%E5%AF%BC%E5%85%A5%E5%BF%85%E8%A6%81%E7%9A%84-node.js-%E5%BA%93) 。 2\. 搜索用户持仓[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#2.-%E6%90%9C%E7%B4%A2%E7%94%A8%E6%88%B7%E6%8C%81%E4%BB%93) ------------------------------------------------------------------------------------------------------------------------------------------------------ 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义用户持仓查询的参数。 const domain = 'https://web3.okx.com'; const exploreBasePath = '/api/v5/defi/explore'; const transactionBasePath = '/api/v5/defi/transaction'; const userBasePath = '/api/v5/defi/user'; const calculatorBasePath = '/api/v5/defi/calculator'; const exploreBaseUrl = domain + exploreBasePath; // Explore API base url const transactionBaseUrl = domain + transactionBasePath; // Transaction API base url const userBaseUrl = domain + userBasePath; // User API base url const calculatorBaseUrl = domain + calculatorBasePath; // Calculator API base url const getUserAssetBody = { "address":"0x7f****da", "investmentId":"15299", "chainId":"137" }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getUserAssetData = async () => { return fetch(calculatorBaseUrl + '/asset-detail', { method: 'POST', headers: headersParams, body: JSON.stringify(getUserAssetBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: userAssetData } = await getUserAssetData(); console.log(userAssetData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": [\ {\ "investmentName": "MATIC earn MATIC",\ "investmentId": "15299",\ "investType": "5",\ "investName": "Stake",\ "assetsTokenList":\ [\ {\ "tokenSymbol": "MATIC",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "MATIC",\ "tokenPrecision": "18",\ "coinAmount": "0E-18",\ "currencyAmount": "0"\ }\ ],\ "rewardDefiTokenInfo":\ [\ {\ "baseDefiTokenInfos":\ [\ {\ "tokenSymbol": "MATIC",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "MATIC",\ "tokenPrecision": "18",\ "coinAmount": "10.907755587159277921",\ "currencyAmount": "8.3804286176144732267043",\ "buttonType": "3"\ }\ ],\ "buttonType": "0",\ "claimMode": "1",\ "rewardType": "1"\ }\ ],\ "totalValue": "8.3804286176144732267043"\ }\ ] } 3\. 搜索平台信息并获取投资品详情[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#3.-%E6%90%9C%E7%B4%A2%E5%B9%B3%E5%8F%B0%E4%BF%A1%E6%81%AF%E5%B9%B6%E8%8E%B7%E5%8F%96%E6%8A%95%E8%B5%84%E5%93%81%E8%AF%A6%E6%83%85) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义查询授权额度的参数。 const getProductDetailParam = { investmentId: '21010', investmentCategory: '' }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getProductDetailRequestUrl = (api, queryParams) => { const path = api + '?' + new URLSearchParams(queryParams).toString(); return { apiRequestUrl: exploreBaseUrl + path, path: exploreBasePath + path, }; }; const getProductDetailData = async () => { const { apiRequestUrl, path } = getProductDetailRequestUrl( '/product/detail', getProductDetailParam ); return fetch(apiRequestUrl, { method: 'GET', headers: headersParams, }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: productDetailData } = await getProductDetailData(); console.log(productDetailData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "investmentId": "21010", "investmentName": "USDC-ETH", "chainId": "324", "rate": "0.06340", "investType": "2", "platformName": "SpaceFi", "platformId": "491", "analysisPlatformId": "294", "poolVersion": "1", "rateType": "1", "tvl": "4464444.45647", "underlyingToken": [\ {\ "tokenSymbol": "USDC",\ "tokenAddress": "0x3355df6d4c9c3035724fd0e3914de96a5a83aaf4",\ "isBaseToken": false\ },\ {\ "tokenSymbol": "ERA_ETH",\ "tokenAddress": "0x0000000000000000000000000000000000000000",\ "isBaseToken": true\ }\ ], "isInvestable": true, "earnedToken": [\ {\ "tokenSymbol": "USDC",\ "tokenAddress": "0x3355df6d4c9c3035724fd0e3914de96a5a83aaf4",\ "isBaseToken": false\ },\ {\ "tokenSymbol": "ERA_ETH",\ "tokenAddress": "0x0000000000000000000000000000000000000000",\ "isBaseToken": true\ }\ ], "lpToken": [\ {\ "tokenSymbol": "SLP",\ "tokenAddress": "0xd0ce094412898760c2a5e37abec39b0e785b45ae",\ "isBaseToken": false\ }\ ], "subscriptionMethod": "2", "redeemMethod": "2" } } 4\. 赎回预估信息计算[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#4.-%E8%B5%8E%E5%9B%9E%E9%A2%84%E4%BC%B0%E4%BF%A1%E6%81%AF%E8%AE%A1%E7%AE%97) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 你可以通过输入的赎回金额获得预估实际赎回信息。 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义计算赎回预估收益的参数。 const getRedeemInfoBody = { address: "0x7f****da", inputTokenAmount: "1.000000146425127036", investmentCategory: "0", investmentId: "21033", isSingle: false, outputTokenAddress: "0x6b175474e89094c44da98b954eedeac495271d0f", outputTokenDecimal: "18", slippage: "" }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getRedeemInfoData = async () => { return fetch(calculatorBaseUrl + '/redeem-info', { method: 'POST', headers: headersParams, body: JSON.stringify(getRedeemInfoBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: redeemInfoData } = await getRedeemInfoData(); console.log(redeemInfoData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "investWithTokenList": [\ {\ "tokenSymbol": "CORE",\ "tokenName": "Core",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "chainId": "1116",\ "tokenPrecision": "18",\ "isBaseToken": true,\ "coinAmount": "1",\ "currencyAmount": "0.4918"\ }\ ], "gainsTokenList": [\ {\ "tokenSymbol": "CORE",\ "tokenName": "Core",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "tokenPrecision": "18",\ "coinAmount": "0.00069321843585011",\ "dataType": "0"\ }\ ], "approveStatusList": [\ {\ "tokenSymbol": "CORE",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "chainId": "1116",\ "tokenPrecision": "18",\ "isNeedApprove": false,\ "approveAddress": "0x0000000000000000000000000000000000001007",\ "orderType": "3"\ }\ ], "isSwapInvest": false, "estimateGasFee": "99343", "isAllowSubscribe": true, "validatorName": "OKXEarn" } } 5\. 生成用于赎回交易的调用数据[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#5.-%E7%94%9F%E6%88%90%E7%94%A8%E4%BA%8E%E8%B5%8E%E5%9B%9E%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 我们进行认购的流程如下： ### 5.1 赎回授权[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#5.1-%E8%B5%8E%E5%9B%9E%E6%8E%88%E6%9D%83) 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义计算投资赎回授权额度的参数。 const userInputList = [\ {\ "chainId": "56",\ "coinAmount": "10",\ "tokenAddress": "0x526a913a7a4518aa2abc3dcd3c46a9c73f40f94a"\ }\ ]; const getTransactionAuthorizationBody = { address: '0x7f****da', type: '4', investmentId: '6925', userInputList: userInputList }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getTransactionAuthorizationData = async () => { return fetch(transactionBaseUrl + '/authorization', { method: 'POST', headers: headersParams, body: JSON.stringify(getTransactionAuthorizationBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: transactionAuthorizationData } = await getTransactionAuthorizationData(); console.log(transactionAuthorizationData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "dataList": [\ {\ "from": "0x7f****da",\ "to": "0x52****4a",\ "value": "0x0",\ "serializedData": "0x095ea7b30000000000000000000000002c34a2fb1d0b4f55de51e1d0bdefaddce6b7cdd60000000000000000000000000000000000000000000000008ac7230489e80000",\ "originalData": "{\"methodDefine\":\"approve(address,uint256)\",\"methodId\":\"0x095ea7b3\",\"methodType\":\"METHOD_ID\",\"params\":{\"params\":[\"0x2c34a2fb1d0b4f55de51e1d0bdefaddce6b7cdd6\",\"10000000000000000000\"]},\"useAdapter\":false}",\ "signatureData": "1bca0efbd1c809de94cdd8c924329c7ac79a4d346742de61925e8494f2c84c446bd3cf42b56d690c85ff513beadf46cd18f4e3e74845a92c48451584615f749d1c"\ }\ ] } } ### 5.2 赎回交易[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#5.2-%E8%B5%8E%E5%9B%9E%E4%BA%A4%E6%98%93) 以下是一个 Node.js 请求的示例。接口详情看[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) 。 #### **步骤 1：定义参数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-1%EF%BC%9A%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0) 接下来，定义查询赎回投资品的参数。 const userInputList = [\ {\ "coinAmount": "0.6"\ }\ ]; const getTransactionRedemptionBody = { address: '0x7f****da', investmentId: '6925', userInputList: userInputList, extra: "{\"redeemAll\":1}" }; #### **步骤 2：定义辅助函数**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-2%EF%BC%9A%E5%AE%9A%E4%B9%89%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0) 定义一个辅助函数，用于与 DeFi API 进行交互。 const getTransactionRedemptionData = async () => { return fetch(transactionBaseUrl+'/redemption', { method: 'POST', headers: headersParams, body: JSON.stringify(getTransactionRedemptionBody), }) .then((res) => res.json()) .then((res) => { return res; }); }; #### **步骤 3：获取结果**[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#%E6%AD%A5%E9%AA%A4-3%EF%BC%9A%E8%8E%B7%E5%8F%96%E7%BB%93%E6%9E%9C) async function someFunction() { const { data: transactionRedemptionData } = await getTransactionRedemptionData(); console.log(transactionRedemptionData); } someFunction(); 发送交易后，你将收到以下响应： { "code": 0, "msg": "", "data": { "dataList": [\ {\ "callDataType": "WITHDRAW",\ "from": "0x7f****da",\ "to": "0x83****ea",\ "value": "0x0",\ "serializedData": "0xba08765200000000000000000000000000000000000000000000000000000000000000000000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da0000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da",\ "originalData": "{\"callDataType\":\"WITHDRAW\",\"methodDefine\":\"redeem(uint256,address,address)\",\"methodId\":\"0xba087652\",\"methodType\":\"METHOD_ID\",\"params\":{\"params\":[\"0\",\"0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da\",\"0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da\"]},\"useAdapter\":false}",\ "signatureData": "e6beeb6f9df6ecb7eb7791e57226f9eca1d7c3efa869172bb5021b9c827ad21b46e3dc4566608af727555e0a47aa90cf261331f4e1691b0201aa0b8a00ea685b1b"\ }\ ] } } 6\. 签名和广播[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#6.-%E7%AD%BE%E5%90%8D%E5%92%8C%E5%B9%BF%E6%92%AD) -------------------------------------------------------------------------------------------------------------------------------------------- 签名时可以直接使用第三步获得的 serializedData 作为 Call data，也可以由用户通过 originalData 自己拼装 Call data 进行签名广播。EVM 类投资品参考签名[示例](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-multi-chain#%E7%AC%AC%E4%B8%89%E6%AD%A5%EF%BC%9A%E6%9E%84%E5%BB%BA%E5%B9%B6%E5%8F%91%E9%80%81%E4%BA%A4%E6%98%93) 。 [申购流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-subscription-flow) [领取奖励流程](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-bonus-flow) 目录 [1\. 设置你的环境](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#1.-%E8%AE%BE%E7%BD%AE%E4%BD%A0%E7%9A%84%E7%8E%AF%E5%A2%83) [2\. 搜索用户持仓](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#2.-%E6%90%9C%E7%B4%A2%E7%94%A8%E6%88%B7%E6%8C%81%E4%BB%93) [3\. 搜索平台信息并获取投资品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#3.-%E6%90%9C%E7%B4%A2%E5%B9%B3%E5%8F%B0%E4%BF%A1%E6%81%AF%E5%B9%B6%E8%8E%B7%E5%8F%96%E6%8A%95%E8%B5%84%E5%93%81%E8%AF%A6%E6%83%85) [4\. 赎回预估信息计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#4.-%E8%B5%8E%E5%9B%9E%E9%A2%84%E4%BC%B0%E4%BF%A1%E6%81%AF%E8%AE%A1%E7%AE%97) [5\. 生成用于赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#5.-%E7%94%9F%E6%88%90%E7%94%A8%E4%BA%8E%E8%B5%8E%E5%9B%9E%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) [6\. 签名和广播](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart-redemption-flow#6.-%E7%AD%BE%E5%90%8D%E5%92%8C%E5%B9%BF%E6%92%AD) --- # 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) 获取交易信息 获取交易信息[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction#%E8%8E%B7%E5%8F%96%E4%BA%A4%E6%98%93%E4%BF%A1%E6%81%AF) =================================================================================================================================================== 交易前信息板块，主要包含获取交易前的相关数据和验证。 [签名所需数据\ \ 提供签名时所需的网络费用和 nonce 等参数。](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas price\ \ 动态获取 EVM 账户模型、UTXO 模型网络的 gas price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas limit\ \ 获取预估消耗的 Gaslimit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce\ \ 获取交易序号 Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [Sui object\ \ 获取 SUI 链上的对象](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验\ \ 交易前，判断是否地址格式有效](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) --- # 创建 Ordinals 挂单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) 创建 Ordinals 挂单 创建 Ordinals 挂单[#](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api#%E5%88%9B%E5%BB%BA-ordinals-%E6%8C%82%E5%8D%95) =================================================================================================================================== [获取铭文资产列表\ \ 查询铭文资产](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions) [提交挂单\ \ 提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions) --- # 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) 用户 用户[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal#%E7%94%A8%E6%88%B7) =================================================================================================== [查询用户全网持仓列表\ \ 获取用户全网持仓列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户协议维度持仓列表\ \ 获取用户协议维度持仓列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户投资品维度的持仓列表\ \ 获取用户投资品维度持仓列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的余额列表\ \ 获取用户余额列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [查询用户的赎回申请列表\ \ 获取用户赎回申请列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) --- # 计算 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [查询认购的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) [查询赎回的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) 计算 计算[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation#%E8%AE%A1%E7%AE%97) ====================================================================================================== [查询认购的预估计算信息\ \ 获取认购预估计算信息的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) [查询赎回的预估计算信息\ \ 获取赎回预估计算信息的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [查询认购的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) --- # 账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) 账户维度查资产 账户维度查资产[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account#%E8%B4%A6%E6%88%B7%E7%BB%B4%E5%BA%A6%E6%9F%A5%E8%B5%84%E4%BA%A7) =========================================================================================================================================================== 提供账户维度下的各类资产查询。 [总估值\ \ 获取账户维度的总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) [资产明细\ \ 获取账户维度下的资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) [查询特定代币\ \ 查询账户维度下某个指定代币的余额](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) --- # NFT API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [获取 NFT 详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details) [获取 NFT 列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) NFT API NFT API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api#nft-api) ===================================================================================== [获取 NFT 详情\ \ 获取代币详情、合集信息、合约信息等](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details) [获取 NFT 列表\ \ 获取欧易平台上特定链和合约地址下的 NFT 列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [获取 NFT 详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details) --- # 查询用户的赎回申请列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) 查询用户的赎回申请列表 查询用户的赎回申请列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list#%E6%9F%A5%E8%AF%A2%E7%94%A8%E6%88%B7%E7%9A%84%E8%B5%8E%E5%9B%9E%E7%94%B3%E8%AF%B7%E5%88%97%E8%A1%A8) ================================================================================================================================================================================================================= 描述：该 API 将提供用户某个投资品已申请过赎回，可赎回本金加奖励金的列表。目前有 Ankr、BENQI、Stader、Lido、Tranchess 这些协议支持。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET **`https://web3.okx.com/api/v5/defi/user/investment/unstake-list`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | investmentId | 投资品 ID ([这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list)
获取) | 请求体 | 是 | String | | userAddress | 用户钱包地址 | 请求体 | 是 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | userAddress | 用户钱包地址 | String | | investmentId | 投资品 ID | String | | canClaimAll | 是否可以全部领取 | Boolean | | coinAmount | 币中数额总数 | String | | currencyAmount | 币种美元价值总数 | String | | rewardTokenInfos | 奖励代币信息 | String | | \>rewardType | 奖励类型 | String | | \>claimIndex | 领取索引 | String | | \>tokenSymbol | 币种标识 | String | | \>tokenLogo | 币种 logo 网址 | String | | \>tokenAddress | 币种合约地址 | String | | \>network | 币种网络 | String | | \>tokenPrecision | 币种精度 | String | | \>coinAmount | 币种数量 | String | | \>currencyAmount | 币种数量美元价值 | String | | \>rewardDescription | 奖励描述 | String | | \>rewardTip | 奖励贴士 | String | [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'http://web3.okx.com/api/v5/defi/user/investment/unstake-list?investmentId=10005&userAddress=0x7f****da' \ --header 'OK-ACCESS-KEY: 90****d6' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "userAddress": "0x7f****da", "investmentId": 10005, "canClaimAll": false, "coinAmount": "3.545420552003607329", "currencyAmount": "1.574166725089601654076", "rewardTokenInfos": [\ {\ "rewardType": 2,\ "claimIndex": "0",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "AVAX",\ "tokenSymbol": "AVAX",\ "tokenLogo": "https://static.coinall.ltd/cdn/wallet/logo/AVAX.png",\ "tokenPrecision": "18",\ "coinAmount": "2.393874828838042349",\ "currencyAmount": "1.062880424004090802956",\ "buttonType": 3,\ "rewardDesc": "By tapping Claim, you’ll redeem sAVAX",\ "rewardTip": "This number refers to the amount of AVAX you can claim. According to the protocol, you’ll claim sAVAX as the claim time is overdue."\ },\ {\ "rewardType": 2,\ "claimIndex": "1",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "AVAX",\ "tokenSymbol": "AVAX",\ "tokenLogo": "https://static.coinall.ltd/cdn/wallet/logo/AVAX.png",\ "tokenPrecision": "18",\ "coinAmount": "1.004954892370271051",\ "currencyAmount": "0.446199972212400346644",\ "buttonType": 3,\ "rewardDesc": "By tapping Claim, you’ll redeem sAVAX",\ "rewardTip": "This number refers to the amount of AVAX you can claim. According to the protocol, you’ll claim sAVAX as the claim time is overdue."\ },\ {\ "rewardType": 3,\ "claimIndex": "2",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "AVAX",\ "tokenSymbol": "AVAX",\ "tokenLogo": "https://static.coinall.ltd/cdn/wallet/logo/AVAX.png",\ "tokenPrecision": "18",\ "coinAmount": "0.146590830795293929",\ "currencyAmount": "0.065086328873110504476",\ "buttonType": 2,\ "rewardDesc": "Est. claimable date: 07/12/23",\ "rewardTip": "This only refers to the estimated claimable time. The exact time is subject to your actual claim."\ }\ ] } } [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) --- # 合集 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [获取合集详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details) [获取合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 合集 API 合集 API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api#%E5%90%88%E9%9B%86-api) ========================================================================================================== [获取合集详情\ \ 获取单个合集的详细信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details) [获取合集列表\ \ 获取欧易平台上的合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list) [获取资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list) [获取合集详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details) --- # 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) 地址维度查资产 地址维度查资产[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address#%E5%9C%B0%E5%9D%80%E7%BB%B4%E5%BA%A6%E6%9F%A5%E8%B5%84%E4%BA%A7) =========================================================================================================================================================== 提供地址维度下的各类资产查询。 [总估值\ \ 获取地址资产总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细\ \ 查询地址持有的代币及余额](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币\ \ 查询某个指定代币的余额](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO\ \ 查询地址持有的全部 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文\ \ 查询 UTXO 上的特定铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权\ \ 查询地址下的授权详情](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) --- # 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [NFT 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) [资产相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) [合集相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) [订单相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 模型 模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models#%E6%A8%A1%E5%9E%8B) ========================================================================================== [NFT 相关模型\ \ 获取 NFT 相关模型的信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) [资产相关模型\ \ 获取资产相关模型的信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) [合集相关模型\ \ 获取合集相关模型的信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) [订单相关模型\ \ 获取订单相关模型的信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) [Ordinals 相关模型\ \ 获取 Ordinals 相关模型的信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [NFT 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) --- # 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) 查询信息 查询信息[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore#%E6%9F%A5%E8%AF%A2%E4%BF%A1%E6%81%AF) ====================================================================================================================== [查询协议列表\ \ 获取协议列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询代币列表\ \ 获取代币列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品列表\ \ 获取产品列表的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询产品详情\ \ 获取产品详情的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [查询网络列表\ \ 获取支持网络信息的示例](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) --- # 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) 订单 API 订单 API[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api#%E8%AE%A2%E5%8D%95-api) ===================================================================================================== [查询挂单\ \ 查询指定 NFT 的有效欧易 Seaport 协议挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单\ \ 查询指定 NFT 的有效欧易 Seaport 协议出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单\ \ 购买指定的订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [获取合集交易信息\ \ 获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单\ \ 创建一个欧易的挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [获取合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) --- # API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) API 参考 API 参考[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference#api-%E5%8F%82%E8%80%83) ========================================================================================================= [获取支持的链\ \ 链列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [交易授权\ \ 交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表\ \ 获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单\ \ 创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表\ \ 查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata\ \ 获取取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单\ \ 查询限价单详情](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) --- # API 参考 | 跨链 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-api) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-chains) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-get-tokens) [获取仅跨链桥交易的币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-tokens) [获取仅通过跨链桥交易的币对列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-bridge-tokens-pairs) [获取支持的桥信息](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-bridges) [获取路径信息](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-route-information) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-approve-transaction) [跨链兑换](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-swap) [查询交易状态](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-transaction-status) [支持的跨链桥](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-supported-bridges) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-faq) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) API 参考 API 参考[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-api#api-%E5%8F%82%E8%80%83) ================================================================================================== [获取支持的链\ \ 获取支持跨链兑换的链信息](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-chains) [获取币种列表\ \ 获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-get-tokens) [获取仅跨链桥交易的币种列表\ \ 获取仅跨链桥交易的币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-tokens) [获取仅通过跨链桥交易的币对列表\ \ 获取仅通过跨链桥交易的币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-bridge-tokens-pairs) [获取支持的桥信息\ \ 获取支持的桥信息](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-bridges) [获取路径信息\ \ 通过欧易 DEX 跨链聚合器获取综合最优路径](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-route-information) [交易授权\ \ 提供发起授权交易前所需要的交易信息](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-approve-transaction) [跨链兑换\ \ 获取跨链兑换所需的交易数据](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-swap) [查询交易状态\ \ 根据 txhash 查询跨链兑换最终交易状态](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-transaction-status) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-get-supported-chains) --- # 综合币价 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [币价及币种信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) 综合币价 综合币价[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist#%E7%BB%BC%E5%90%88%E5%B8%81%E4%BB%B7) =============================================================================================================================== 综合币价指通过多个第三方数据源的价格,计算出来的一个币价。 批量查询币种的综合价格。 * 支持主链币、代币的综合币价 * 支持 Bitcoin 链上的 BRC-20、Runes、ARC-20、SRC-20 铭文代币的综合币价 * 支持 Fractal Bitcoin 链上的 BRC-20 铭文代币的综合币价。 每次最多可以批量查询 100 个代币的综合价格，按请求示例内的数组格式查询。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/token/current-price` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | tokenAddress | String | Yes | 代币地址。
`1`：传""代表查询对应链的主链币。
`2`：传具体的代币合约地址，代表查询对应的代币。
`3`：不同铭文代币按如下格式入参：
`FBRC-20`: 使用 `fbtc_fbrc20_name`，如 fbtc\_fbrc20\_babymusk
`BRC-20`: 使用 `btc-brc20-tick(name)`，如 btc-brc20-ordi
`Runes`: 使用 `btc-runesMain-tickId`，如 btc-runesMain-840000:2
`SRC-20`:使用 `btc-src20-name`，如 btc-src20-utxo | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | price | String | 代币价格，单位为美元 | | time | String | 价格的时间，Unix 时间戳格式，用毫秒表示 | | chainIndex | String | 链唯一标识 | | tokenAddress | String | 代币地址。 | [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/token/current-price' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '[\ {\ "chainIndex": "1",\ "tokenAddress":"0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-brc20-ordi"\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-arc20-00009b954c9f1358de9c089f95ec420132e4106a89c8fbb3cfda198ae1e5f9d5i0"\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-runesMain-840000:2"\ } \ ]' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "chainIndex": "1",\ "tokenAddress": "0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"\ "time": "1716892020000",\ "price": "26.458143090226812",\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-brc20-ordi",\ "time": "1724147119541",\ "price": "32.430139864000000000"\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-arc20-00009b954c9f1358de9c089f95ec420132e4106a89c8fbb3cfda198ae1e5f9d5i0",\ "time": "1724153703045",\ "price": "0.003558564230000000"\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-runesMain-840000:2",\ "time": "1724145196000",\ "price": "0.000455104500000000"\ }\ ] } [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) --- # 签名所需数据 | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) 签名所需数据 签名所需数据[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#%E7%AD%BE%E5%90%8D%E6%89%80%E9%9C%80%E6%95%B0%E6%8D%AE) ======================================================================================================================================= 该接口提供各个链，签名交易时所需数据。 例如 EVM 网络所需的网络费用、nonce 。UTXO 模型网络需要的费率，输出大小等最参数。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/pre-transaction/sign-info` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | fromAddr | String | Yes | From 地址 | | toAddr | String | Yes | To 地址 | | txAmount | String | No | 交易的主链币金额，默认为 0。涉及主链币转账的时候必须要携带此参数，否则将会影响 gaslimit 的计算。以主链币的最小单位传参，例如 ETH wei。 | | extJson | Object | Yes | 扩展参数，用于添加 calldata 等信息 | **extJson** | Parameter | Type | Required | Description | | --- | --- | --- | --- | | inputData | String | No | calldata | | protocol | String | No | 查询指定的协议:
`1`: BRC-20
`2`: ARC-20
`3`: Runes
`4`: ordi\_nft
`5`: SRC-20 | | tokenAddress | String | No | 只适用于 Solana 链 | | permissionType | String | No | 只适用于 Tron 链。
`1`：对地址有 owner 管理控制权限
`2`：对地址有 witness 副监管权限
默认为"1" | | feeLimit | String | No | 只适用于 Tron 链。合约交互必填，默认为 "30000000" | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) #### EVM[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#evm) | Parameter | Type | Description | | --- | --- | --- | | gasLimt | String | gas 消耗数量 | | nonce | String | 当前数，只返回上链 nonce。比如当前地址链上已成功的最大 nonce 为 10，则请求的结果为 11。如需内存池的 nonce 请查看[获取 nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) | | gasPrice | Object | gas 消耗单价 | | \>normal | String | 中档 gasPrice,单位为 wei | | \>min | String | 低档 gasPrice，单位为 wei | | \>max | String | 高档 gasPrice，单位为 wei | | \>supportEip1559 | Boolean | 是否支持 1559 | | \>eip1559Protocol | Object | 1559 协议 | **eip1559 Protocol** | Parameter | Type | Description | | --- | --- | --- | | eip1559Protocol | Object | 1559 协议 | | \>baseFee | String | 基础费用 | | \>proposePriorityFee | String | 中档小费，单位为 wei | | \>safePriorityFee | String | 低档小费，单位为 wei | | \>fastPriorityFee | String | 高档小费，单位为 wei | #### UTXO[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#utxo) | Parameter | Type | Description | | --- | --- | --- | | normalFeeRate | String | 中档位费率 | | maxFeeRate | String | 高档位费率 | | minFeeRate | Object | 低档位费率 | | inscriptionOutput | String | 铭文输出大小。若 protocol 为空，默认为 BRC20 的铭文输出大小 | | minOutput | String | 铭文最小输出大小，单位为聪（通常为 546 聪） | | normalCost | String | 单笔铭刻交易的消耗，单位为聪 | | maxCost | String | 单笔铭刻交易的最大消耗，单位为聪 | | minCost | String | 单笔铭刻交易的最小消耗，单位为聪 | #### Solana[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#solana) | Parameter | Type | Description | | --- | --- | --- | | baseFee | String | 基础费用 | | priorityFee | String | 优先费 | | \>normalUnitPrice | Object | 中档gasPrice | | \>minUnitPrice | String | 低档gasPrice | | \>maxUnitPrice | String | 高档gasPrice | | recentBlockHash | String | 最近的区块哈希 | | lastValidBlockHeight | String | 上一区块高度 | | fromAddressRent | String | 发送地址租金 | | toAddressRent | String | 目的地址租金 | | tokenAccountInfo | String | from 地址的代币账户信息。代币转账时存在 | | \>lamports | String | 余额 | | \>ownerAddress | String | form 地址 | | \>mintAddress | String | 代币地址 | | \>tokenAccountAddress | String | 代币账户地址 | | \>decimal | String | 精度 | #### Tron[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#tron) | Parameter | Type | Description | | --- | --- | --- | | fee | String | 手续费 | | refBlockBytes | String | 交易引用块的高度，使用了引用块高度的第6到8（不包含）字节，用于帮助验证交易是否基于当前区块链的有效状态,防止分叉交易重放 | | refBlockHash | Object | 交易引用块的hash，使用了引用块hash的第8到16(不包含)字节。如果交易的ref\_block\_hash与实际存在的区块哈希不匹配，那么这笔交易可能会被拒绝或标记为无效 | | expiration | String | 过期时间 | | timestamp | String | 时间戳 | [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/pre-transaction/sign-info' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "chainIndex": "0", "fromAddr": "bc1pyyn077ps82t7t0zjs0rlueg5876sdrqk79esr5e2w44g5f59dsmsl6m02d", "toAddr": "bc1pyyn077ps82t7t0zjs0rlueg5876sdrqk79esr5e2w44g5f59dsmsl6m02d", "txAmount": "0", "extJson": { "protocol": "1" } } ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 // EVM { "code": "0", "data": [\ {\ \ "gasLimit": "21000",\ "nonce": "15",\ "gasPrice": {\ "normal": "21289500000", //中档gasPrice\ "min": "15670000000", //低档gasPrice\ "max": "29149000000", //高档gasPrice\ "supportEip1559": true, //是否支持1559\ "eip1599Protocol": {\ "suggestBaseFee": "15170000000", //建议基础费用\ "baseFee": "15170000000", //基础费用\ "proposePriorityFee": "810000000", //中档小费\ "safePriorityFee": "500000000", //低档小费\ "fastPriorityFee": "3360000000" //高档小费\ }\ }\ }\ ], "msg": "" } // UTXO/ BRC-20 { "code": "0", "data": [\ {\ "normalFeeRate": "27",\ "maxFeeRate": "35",\ "minFeeRate": "22",\ "inscriptionOutput": "546",\ "minOutput": "1500",\ "normalCost": "1800",\ "maxCost": "3600",\ "minCost": "600"\ }\ ] } //Solana { "code": "0", "msg": "success", "data": [\ {\ \ "baseFee": "5000",\ "priorityFee": {\ "normalUnitPrice": "4325963",\ "minUnitPrice": "4325963",\ "maxUnitPrice": "4325963"\ },\ "recentBlockHash": "C7Qq7cLjBQSU2eTS7458DDe1HvmBubLv9wi4NMH9GGtc",\ "lastValidBlockHeight": "280957599",\ "fromAddressRent": "890880",\ "toAddressRent": "0",\ "tokenAccountInfo": {\ "lamports": "2039280",\ "ownerAddress": "HnRfqMVCpYAvTVRZJJtrR5j2Kx8qvz4HvE3eL4hUgheV",\ "mintAddress": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",\ "tokenAccountAddress": "CFYZjn1dVWzbwDq7zuXtwa2NystiqA4QALKqMoA98TB6",\ "decimal": "6"\ }\ }\ ] } // TRON { "code": "0", "msg": "success", "data": [\ {\ "fee": "3150000",\ "refBlockBytes": "8cfe",\ "refBlockHash": "dc8399fedb8cf542",\ "expiration": "1732088289000",\ "timestamp": "1732084764202"\ }\ ] } [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) * * * --- # 实时币价 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [币价及币种信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) 实时币价 实时币价[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist#%E5%AE%9E%E6%97%B6%E5%B8%81%E4%BB%B7) ================================================================================================================================ 批量查询币种的实时价格。 只支持代币（非主网币）的实时币价 每次最多可以批量查询 100 个代币的实时价格，按请求示例内的数组格式查询。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/token/real-time-price` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | tokenAddress | String | Yes | 代币地址。 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | price | String | 代币价格，单位为美元 | | time | String | 价格的时间，Unix 时间戳格式，用毫秒表示 | | chainIndex | String | 链唯一标识 | | tokenAddress | String | 代币地址。 | [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/token/real-time-price' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '[\ {\ "chainIndex": "1",\ "tokenAddress":"0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"\ }\ ]' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "chainIndex": "1",\ "tokenAddress": "0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"\ "time": "1716892020000",\ "price": "26.458143090226812",\ }\ ] } [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) --- # Gas Price | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) Gas Price Gas Price[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#gas-price) ============================================================================================= 动态获取各个链的预估 gas price，支持 EIP-1559，覆盖 EVM、UTXO 模型的网络。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/pre-transaction/gas-price` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) #### EVM[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#evm) | Parameter | Type | Description | | --- | --- | --- | | \>normal | String | 中档 gasPrice，单位为 wei | | \>min | String | 低档 gasPrice，单位为 wei | | \>max | String | 高档 gasPrice，单位为 wei | | \>supporteip1559 | Boolean | 是否支持 1559 | | \>eip1559Protocol | Object | 1559 协议 | ##### eip1559 Protocol | Parameter | Type | Description | | --- | --- | --- | | eip1559Protocol | Object | 1559 协议结构 | | \>baseFee | String | 基础费用，单位为 wei | | \>proposePriorityFee | String | 中档小费，单位为 wei | | \>safePriorityFee | String | 低档小费，单位为 wei | | \>fastPriorityFee | String | 高档小费，单位为 wei | #### BRC-20/UTXO[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#brc-20/utxo) | Parameter | Type | Description | | --- | --- | --- | | normalFeeRate | String | 中档位费率 | | maxFeeRate | String | 高档位费率 | | minFeeRate | Object | 低档位费率 | | inscriptionOutput | String | 铭文输出大小 | | minOutput | String | 铭文最小输出大小，单位为聪（通常为 546 聪） | | normalCost | String | 单笔铭刻交易的消耗，单位为聪 | | maxCost | String | 单笔铭刻交易的最大消耗，单位为聪 | | minCost | String | 单笔铭刻交易的最小消耗，单位为聪 | [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/pre-transaction/gas-price?chainIndex=1' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 // EVM { "code": "0", "data": [\ {\ "normal" : "21289500000", //中档gasPrice\ "min" : "15670000000",//低档gasPrice\ "max" : "29149000000", //高档gasPrice \ "supportEip1559" : true,//是否支持1559\ "erc1599Protocol": {\ "suggestBaseFee" : "15170000000",//建议基础费用\ "baseFee" : "15170000000",//基础费用\ "proposePriorityFee" : "810000000",//中档小费\ "safePriorityFee" : "500000000",//低档小费\ "fastPriorityFee" : "3360000000"//高档小费\ }\ } \ ], "msg": "" } // UTXO { "code": "0", "data": [\ {\ "normalFeeRate": "27",\ "maxFeeRate": "35",\ "minFeeRate": "22",\ "inscriptionOutput": "546",\ "minOutput": "1500",\ "normalCost": "1800",\ "maxCost": "3600",\ "minCost": "600"\ }\ ], "msg": "" } [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) --- # 历史币价 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [币价及币种信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) 历史币价 历史币价[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price#%E5%8E%86%E5%8F%B2%E5%B8%81%E4%BB%B7) ============================================================================================================================== 查询某个币种的历史价格。 * 支持主链币、代币的历史币价 * 支持 Bitcoin 链上的 BRC-20、Runes、ARC-20、SRC-20 铭文代币的历史币价 * 支持 Fractal Bitcoin 链上的 BRC-20 铭文代币的历史币价。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/token/historical-price` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | tokenAddress | String | No | 代币地址。
`1`：传""代表查询对应链的主链币。
`2`：传具体的代币合约地址，代表查询对应的代币。
`3`：不同铭文代币按如下格式入参：
`FBRC-20`: 使用 `fbtc_fbrc20_name`，如 fbtc\_fbrc20\_babymusk
`BRC-20`: 使用 `btc-brc20-tick(name)`，如 btc-brc20-ordi
`Runes`: 使用 `btc-runesMain-tickId`，如 btc-runesMain-840000:2
`SRC-20`:使用 `btc-src20-name`，如 btc-src20-utxo | | limit | String | No | 每次查询多少条，默认值为 50，最大 200 | | cursor | String | No | 游标位置，默认为第一个 | | begin | String | No | 开始时间，查询晚于该时间的历史币价。Unix时间戳，用毫秒表示 | | end | String | No | 结束时间，查询早于该时间的历史币价。若 begin 和 end 都不传，查询当前时间以前的历史币价。Unix 时间戳，用毫秒表示 | | period | String | No | 时间间隔单位:
`1m`: 1分钟
`5m`: 5分钟
`30m`: 30分钟
`1h`: 1小时
`1d`: 1天（默认） | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | prices | Array | 历史价格的列表 | | \>time | String | 分钟时间戳（整分钟） | | \>price | String | 币种价格，单位为美元，18 位精度 | | cursor | String | 游标位置 | [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell For EVM: curl --location --request GET 'https://web3.okx.com/api/v5/wallet/token/historical-price?chainIndex=1&limit=5&begin=1700040600000&period=5m' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' For BTC: curl --location --request GET 'https://web3.okx.com/api/v5/wallet/token/historical-price?chainIndex=0&limit=5&period=5m&tokenAddress=btc-brc20-ordi' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "cursor":"31",\ "prices":[\ {\ "time": "1700040600000",\ "price": "1994.430000000000000000"\ },\ {\ "time": "1700040300000",\ "price": "1994.190000000000000000"\ },\ {\ "time": "1700040000000",\ "price": "1992.090000000000000000"\ },\ {\ "time": "1700039700000",\ "price": "1992.190000000000000000"\ },\ {\ "time": "1700039400000",\ "price": "1990.190000000000000000"\ }\ ]\ }\ ] } [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) --- # Gas Limit | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) Gas Limit Gas Limit[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit#gas-limit) ============================================================================================= 通过交易信息的预执行，获取预估消耗的 Gaslimit 。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/pre-transaction/gas-limit` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | fromAddr | String | Yes | From 地址 | | toAddr | String | Yes | To 地址 | | txAmount | String | No | 交易的主链币金额，默认为0。
涉及主网币转账的时候必须要携带此参数， 否则将会影响 gaslimit 的计算,以主网币的最小单位传参，例如 ETH wei 。 | | extJson | Object | No | 扩展参数，用于添加 calldata 等信息 | extJson | Parameter | Type | Required | Description | | --- | --- | --- | --- | | inputData | String | No | calldata | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | gasLimit | String | 预估gas limit数额 | [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/pre-transaction/gas-limit' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "fromAddr": "0x383c8208b4711256753b70729ba0cf0cda55efad", "toAddr": "0x4ad041bbc6fa102394773c6d8f6d634320773af4", "txAmount": "31600000000000000", "chainIndex": "1", "extJson": { "inputData":"041bbc6fa102394773c6d8f6d634320773af4" } }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "gasLimit": "652683"\ }\ ], "msg": "" } [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) --- # 项目信息 | 币价及币种信息 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [综合币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-current-pricelist) [实时币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-realtime-pricelist) [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [币价及币种信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) 项目信息 项目信息[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail#%E9%A1%B9%E7%9B%AE%E4%BF%A1%E6%81%AF) ====================================================================================================================== 查询单个币种的其他信息，诸如币种合约地址、代币官网 URL、社媒信息。 * 支持主链币、代币的项目信息 * 支持 Bitcoin 链上的 BRC-20、Runes、ARC-20、SRC-20 铭文代币的项目信息 * Fractal Bitcoin 链上的 BRC-20 铭文代币的项目信息 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/token/token-detail` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | tokenAddress | String | No | 代币地址。
`1`：传""代表查询对应链的主链币。
`2`：传具体的代币合约地址，代表查询对应的代币。
`3`：不同铭文代币按如下格式入参：
`FBRC-20`: 使用 `fbtc_fbrc20_name`，如 fbtc\_fbrc20\_babymusk
`BRC-20`: 使用 `btc-brc20-tick(name)`，如 btc-brc20-ordi
`Runes`: 使用 `btc-runesMain-tickId`，如 btc-runesMain-840000:2
`SRC-20`:使用 `btc-src20-name`，如 btc-src20-utxo | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | logoUrl | String | logo 地址 | | officialWebsite | String | 官方网站的地址 | | socialUrls | Object | 社交媒体 | | \> twitter | Array | 如存在，则返回，否则不返回。 | | \> facebook | Array | 如存在，则返回，否则不返回。 | | \> reddit | Array | 如存在，则返回，否则不返回。 | | \> messageboard | Array | 如存在，则返回，否则不返回。 | | \> chat | Array | 如存在，则返回，否则不返回。 | | \> github | Array | 如存在，则返回，否则不返回。 | | \> whitepaper | Array | 如存在，则返回，否则不返回。 | | \> announcement | Array | 如存在，则返回，否则不返回。 | | decimals | String | 代币精度 | | tokenAddress | String | 代币地址。为空 "" 代表返回结果是相关链，主链币的数据 | | chainIndex | String | 链唯一标识 | | chainName | String | 链名称 | | symbol | String | 代币简称 | | name | String | 代币名称 | | maxSupply | String | 最大供应量（多链汇总，部分代币数据为空）。精度15位 | | totalSupply | String | 总供应量（多链汇总，部分代币数据为空）。精度15位 | | volume24h | String | 24 小时交易额，单位为美元。精度15位。统计范围包括 OKX DEX 接入的所有流动性池。 | | marketCap | String | 项目市值，单位为美元。精度15位 | [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/token/token-detail?chainIndex=56&""&tokenAddress=0x6f620ec89b8479e97a6985792d0c64f237566746' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-detail#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "logoUrl": "https://static.oklink.com/cdn/web3/currency/token/bnb-wpc-0x6f620ec89b8479e97a6985792d0c64f237566746.png/type=png_350_0",\ "officialWebsite": "https://www.wepiggy.com/",\ "socialUrls": {\ "messageboard": [\ "https://wepiggy-com.medium.com/"\ ],\ "github": [\ "https://github.com/WePiggy"\ ],\ "twitter": [\ "https://twitter.com/wepiggydotcom"\ ],\ "chat": [\ "https://t.me/wepiggy;https://discord.com/invite/pew9k58"\ ],\ "reddit": [\ "https://reddit.com/r/WePiggy/"\ ]\ },\ "decimals": "18",\ "tokenAddress": "0x6f620ec89b8479e97a6985792d0c64f237566746",\ "chainIndex": "56",\ "chainName": "BNB Chain",\ "symbol": "wpc"，\ "circulatingSupply": "151703763.020000000000000",\ "maxSupply": "200000000.000000000000000",\ "totalSupply": "",\ "volume24h": "283632981.281666040000000",\ "marketCap": "34510982165.370000000000000"\ }\ ] } [历史币价](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-historical-price) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) --- # 总估值 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) 总估值 总估值[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address#%E6%80%BB%E4%BC%B0%E5%80%BC) ========================================================================================================================= 获取地址下全量 token 和 Defi 资产总余额，支持过滤垃圾空投代币。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/wallet/asset/total-value-by-address` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | address | String | Yes | 查地址总估值 | | chains | String | Yes | 筛选需要查询总资产估值的链，多条链以","分隔。最多支持 50 个 | | assetType | String | No | 查询余额类型，默认查所有资产总余额。0：查询所有资产总余额，包括 token 和 defi 资产 1：只查 token 总余额 2：只查 defi 总余额 | | excludeRiskToken | Boolean | No | 可能存在风险空投代币，可选择是否过滤。默认过滤。true:过滤，false:不过滤" | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | totalValue | String | 根据查询类型返回资产总余额，以美元为单位返回 | [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/asset/total-value-by-address?address=0x0b32aa5c1e71715206fe29b7badb21ad95f272c0&chains=1&assetType=0' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "totalValue": "172.895057177065864522056725546579939398"\ }\ ] } [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) --- # 地址维度查询 | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) 地址维度查询 地址维度查询[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address#%E5%9C%B0%E5%9D%80%E7%BB%B4%E5%BA%A6%E6%9F%A5%E8%AF%A2) ===================================================================================================================================================== 查询地址维度下的交易历史，按时间倒序排序。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/post-transaction/transactions-by-address` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | address | String | Yes | 具体某条链的账户地址 | | chains | String | Yes | 筛选需要查询交易历史的链，多条链以","分隔。最多支持 50 个 | | tokenAddress | String | No | 代币地址。
`1`：传""代表查询对应链的主链币。
`2`：传具体的代币合约地址，代表查询对应的代币。
`3`：不传，代表查询主链币和所有代币。 | | begin | String | No | 开始时间，查询晚于该时间的交易历史。Unix 时间戳，用毫秒表示 | | end | String | No | 结束时间，查询早于该时间的交易历史。若 begin 和 end 都不传，查询当前时间以前的交易历史。Unix 时间戳，用毫秒表示 | | cursor | String | No | 游标 | | limit | String | No | 返回条数，默认返回最近的 20 条。多链查询最多支持 20 条，单链查询最多 100 条 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | transactionList | Array | 交易列表 | | \>chainIndex | String | 链 ID | | \>txHash | String | 交易 hash | | \>iType | String | EVM 交易的层级类型
`0`:外层主链币转移
`1`:合约内层主链币转移
`2`:token转移 | | \>methodId | String | 合约调用函数 | | \>nonce | String | 发起者地址发起的第几笔交易 | | \>txTime | String | 交易时间；Unix时间戳的毫秒数格式，如 1597026383085 | | \>from | Array | 交易输入 | | \>>address | String | 发送/输入地址，多签交易时，逗号分隔 | | \>>amount | String | 输入数量 | | \>to | Array | 交易输出 | | \>>address | String | 接收。输出地址，多签交易时，逗号分隔 | | \>>amount | String | 输出数量 | | \>tokenAddress | String | 代币的合约地址 | | \>amount | String | 交易数量 | | \>symbol | String | 交易数量对应的币种 | | \>txFee | String | 手续费 | | \>txStatus | String | 交易状态、success 成功、fail 失败、pending 等待确认 | | \>hitBlacklist | Boolean | false：不是黑名单 true：是黑名单 | | \>tag | String | 黑地址标签类型，包括貔貅盘、网络钓鱼以及合约漏洞等类型。`已废弃` | | cursor | String | 游标 | [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api//v5/wallet/post-transaction/transactions-by-address?address=0x50c476a139aab23fdaf9bca12614cdd54a4244e4&chains=1'\ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "cursor": "1706197403",\ "transactionList": [\ {\ "chainIndex": "1",\ "txHash": "0x963767695543cfb7804039c470b110b87adf9ab69ebc002b571523b714b828ca",\ "methodId": "",\ "nonce": "",\ "txTime": "1724213411000",\ "from": [\ {\ "address": \ "0xae7ab96520de3a18e5e111b5eaab095312d7fe84"\ "amount": ""\ }\ ],\ "to": [\ {\ "address": \ "0x50c476a139aab23fdaf9bca12614cdd54a4244e4"\ "amount": ""\ }\ ],\ "tokenAddress": "0xe13c851c331874028cd8f681052ad3367000fb13",\ "amount": "1",\ "symbol": "claim rewards on stethdao.net",\ "txFee": "",\ "txStatus": "success",\ "hitBlacklist": true,\ "tag": "Risk Airdrop",\ "itype": "2"\ }\ ]\ }\ ] } [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) * * * --- # Nonce | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) Nonce Nonce[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce#nonce) ================================================================================= 支持 EVM 链查询 Nonce，返回即将上链的 nonce 和内存池 pending 排队的 nonce。 比如，当前地址已上链的最大 nonce 为 10，且内存池池有 nonce 为 11 和 12 正在 pending 。那么 nonce 为 11，pendingNonce 为 13。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/pre-transaction/nonce` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | address | String | Yes | 地址 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | nonce | String | 可上链的 nonce | | pendingNonce | String | 内存池中 pending 的 nonce | [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/pre-transaction/nonce?chainIndex=1&address=0x1ucda' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "nonce": "15",\ "pendingNonce": "21"\ }\ ], "msg": "success" } [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) --- # 总估值 | 账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) 总估值 总估值[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account#%E6%80%BB%E4%BC%B0%E5%80%BC) ========================================================================================================================= 获取账户下全量 token 和 Defi 资产总余额，支持过滤垃圾空投代币。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/wallet/asset/total-value` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | accountId | String | Yes | 查账户总估值 | | chains | String | No | 筛选需要查询总资产的链，多条链以","分隔。最多支持50个 | | assetType | String | No | 查询余额类型，默认查所有资产总余额。0：查询所有资产总余额，包括token和defi资产 1：只查token总余额 2：只查defi总余额 | | excludeRiskToken | Boolean | No | 可能存在风险空投代币，可选择是否过滤。默认过滤。true:过滤，false:不过滤" | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | totalValue | String | 根据查询类型返回资产总余额，以美元为单位返回 | [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/asset/total-value?accountId=e7dba4c2-666d-496a-ad92-768d29291fee&chains=' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "totalValue": "1172.895057177065864522056725546579939398"\ }\ ] } [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) --- # 账户维度查询 | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) 账户维度查询 账户维度查询[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list#%E8%B4%A6%E6%88%B7%E7%BB%B4%E5%BA%A6%E6%9F%A5%E8%AF%A2) ============================================================================================================================================== 查询账户维度下所有或某条链的交易历史，按时间顺序倒序排序。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/post-transaction/transactions` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | accountId | String | Yes | 账户唯一标识符 | | chainIndex | String | No | 链唯一标识, e.g. ETH=3 | | tokenAddress | String | No | 代币地址。
`1`：传""代表查询对应链的主链币。
`2`：传具体的代币合约地址，代表查询对应的代币。
`3`：不传，代表查询主链币和所有代币。 | | begin | String | No | 开始时间，查询晚于该时间的交易历史。 Unix 时间戳，用毫秒表示 | | end | String | No | 结束时间，查询早于该时间的交易历史。 若 begin 和 end 都不传，查询当前时间以前的交易历史。 Unix 时间戳，用毫秒表示 | | cursor | String | No | 游标 | | limit | String | No | 返回条数，默认返回最近的 20 条，最多 20 条 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | transactionList | Array | 交易列表 | | \>chainIndex | String | 链ID | | \>txHash | String | 交易hash | | \>iType | String | EVM 交易的层级类型
`0`:外层主链币转移
`1`:合约内层主链币转移
`2`:token转移 | | \>methodId | String | 方法 | | \>nonce | String | 发起者地址发起的第几笔交易 | | \>txTime | String | 交易时间；Unix 时间戳的毫秒数格式，如 1597026383085 | | \>from | Array | 交易输入 | | \>>address | String | 发送/输入地址，多签交易时，逗号分隔 | | \>>amount | String | 输入数量 | | \>to | Array | 交易输出 | | \>>address | String | 接收。输出地址，多签交易时，逗号分隔 | | \>>amount | String | 输出数量 | | \>tokenAddress | String | 代币的合约地址 | | \>amount | String | 交易数量 | | \>symbol | String | 交易数量对应的币种 | | \>txFee | String | 手续费 | | \>txStatus | String | 交易状态、success 成功、fail 失败、pending 等待确认 | | \>hitBlacklist | Boolean | false：未命中黑名单 true：命中黑名单 | | \>tag | String | 黑地址标签类型，包括貔貅盘、网络钓鱼以及合约漏洞等类型。`已废弃` | | cursor | String | 游标 | [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/post-transaction/transactions?accountId=31f55853-d430-42c5-b4c6-710d39848cd1' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "cursor": "1724212391",\ "transactionList": [\ {\ "chainIndex": "0",\ "txHash": "5fd7e21515b088e2c47641779d53de4ff3b982c7d71a5e85f06f32d8cd4c5bcc",\ "methodId": "",\ "nonce": "",\ "txTime": "1724250342000",\ "from": [\ {\ "address": "bc1pm7fxkgcrqghf2rtxdw4hupvdpqkped7azyrh2mukedrw2p0cj3hsxt8ph3"\ "amount": "0.000432"\ }\ ],\ "to": [\ {\ "address": "bc1pm7fxkgcrqghf2rtxdw4hupvdpqkped7azyrh2mukedrw2p0cj3hsxt8ph3"\ "amount": "0.00010"\ },\ {\ "address": "bc1pm7fxkgcrqghf2rtxdw4hupvdpqkped7azyrh2mukedrw2p0cj3hsxt8ph3"\ "amount": "0.00032738"\ }\ ],\ "tokenAddress": "",\ "amount": "",\ "symbol": "BTC",\ "txFee": "0.00000462",\ "txStatus": "success",\ "hitBlacklist": false,\ "tag": "",\ "iType": ""\ },\ {\ "chainIndex": "1",\ "txHash": "0x307ced97491fdeea9acb141cb3d07939ef3291f28c06c0cacd1cc1f8c435bbe1",\ "methodId": "",\ "nonce": "945",\ "txTime": "1724056787000",\ "from": [\ {\ "address": "0x50c476a139aab23fdaf9bca12614cdd54a4244e4"\ "amount": ""\ }\ ],\ "to": [\ {\ "address": "0x2491889438e5130a4cf629fbc93ae31aad742d8b"\ "amount": ""\ }\ ],\ "tokenAddress": "",\ "amount": "0.00001",\ "symbol": "ETH",\ "txFee": "1.89E-23",\ "txStatus": "success",\ "hitBlacklist": false,\ "tag": "",\ "iType": "0"\ }\ ]\ }\ ] } [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) * * * --- # 资产明细 | 账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) 资产明细 资产明细[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances#%E8%B5%84%E4%BA%A7%E6%98%8E%E7%BB%86) =================================================================================================================================== 查询钱包账户持有的多个链或指定链的 token 余额列表。 余额查询支持： * 主链币 * EVM 链的 ERC20 代币 * Bitcoin 生态的 BRC-20、ARC-20、Runes 和 SRC-20 代币 * Fractal Bitcoin 链的 BRC-20 代币 此外，该接口支持过滤风险空投代币。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/asset/wallet-all-token-balances` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | accountId | String | Yes | 账户唯一标识。 | | chains | String | No | 筛选需要查询资产明细的链，多条链以","分隔。最多支持 50 个 | | filter | String | No | `0`: 过滤风险空投币
`1`: 不过滤风险空投币
默认过滤 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | tokenAssets | Array | 代币余额 | | \>chainIndex | String | 链唯一标识 | | \>tokenAddress | String | 合约地址 | | \>address | String | 钱包地址 | | \>symbol | String | 代币简称 | | \>balance | String | 代币数量 | | \>rawBalance | String | 代币的原始数量。更多的链即将被支持。对于不支持的链，该字段为空。 | | \>tokenPrice | String | 币种单位价值，以美元计价 | | \>tokenType | String | 币种类型:
`1`: 代币
`2`: 铭文 | | \>isRiskToken | Boolean | `true`: 命中风险空投币
`false`: 未命中风险空投币 | | timeStamp | String | 币种获取的时间，Unix 时间戳，用毫秒表示 | [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/asset/wallet-all-token-balances?filter=&chains=1&accountId=31f55853-d430-42c5-b4c6-710d39848cd1' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "tokenAssets": [\ {\ "chainIndex": "1",\ "tokenAddress": "0xf4d2888d29d722226fafa5d9b24f9164c092421e",\ "symbol": "LOOKS",\ "balance": "0.6908810093750312",\ "rawBalance": "",\ "tokenPrice": "0.035834243057603148",\ "tokenType": "1",\ "isRiskToken": false,\ "address":"0xa03400e098f4421b34a3a44a1b4e571419517687"\ \ },\ {\ "chainIndex": "1",\ "tokenAddress": "",\ "symbol": "ETH",\ "balance": "8",\ "rawBalance": "",\ "tokenPrice": "2650.43",\ "tokenType": "1",\ "isRiskToken": false,\ "address":"0xa03400e098f4421b34a3a44a1b4e571419517687"\ }\ ],\ "timeStamp": "1724153197342"\ }\ ], "msg": "success" } [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) * * * --- # SUI Object | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) SUI Object SUI Object[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object#sui-object) ================================================================================================ 查询SUI 链上的所有对象。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/pre-transaction/sui-object` ### Request Parameters[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object#request-parameters) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | address | String | Yes | 钱包地址 | | tokenAddress | String | Yes | 代币地址 | | limit | String | No | 游标位置，默认为第一个 | | cursor | Object | No | 每次查询多少条，默认值为 50，最大 50 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | tokenAddress | String | 币种合约地址 | | objects | Array | object 列表 | | \>amount | String | 币种余额 | | \>digest | String | 32字节事务摘要，指示上次将此对象作为输出包含在内的交易 | | \>version | String | 8字节无符号整数版本，随着每次修改它的事务而单调递增 | | \>objectId | String | 32字节的全局唯一ID。对象ID是从创建对象的交易的摘要和编码交易生成的ID数量的计数器派生的 | | cursor | String | 下一个游标位置 | [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/pre-transaction/sui-object?chainIndex=784&address=0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd&cursor=0x00b6bbf25a188b36c9307909d99449b95d15e08c3a6f0333814d5bddccff5176' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "tokenAddress": "0x2::sui::SUI",\ "cursor": "0x014f206e9de4bf4fbfc4dcc4bca0e2a8e58ff066beb33f7ff64d6ad5beb48419",\ "objects": [\ {\ "amount": "10000004114400",\ "digest": "2izKmAEDZ4dRMPSJaxycRJMuaMVnWBtKSCg24Hx7KwoE",\ "version": "368758084",\ "objectId": "0x014e81bf02d343f87fda11814bca88ee775c1721a61dbc1910f18ea5b13a53c2"\ },\ {\ "amount": "500019226840",\ "digest": "5sMxZk5MvJDCGxjdT8uCkDbEPXRwyhh8zRWuLzDjqsqJ",\ "version": "333512928",\ "objectId": "0x014f206e9de4bf4fbfc4dcc4bca0e2a8e58ff066beb33f7ff64d6ad5beb48419"\ }\ ]\ }\ ] } [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) --- # 查询赎回的预估计算信息 | 计算 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [查询认购的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) [查询赎回的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) 查询赎回的预估计算信息 查询赎回的预估计算信息[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption#%E6%9F%A5%E8%AF%A2%E8%B5%8E%E5%9B%9E%E7%9A%84%E9%A2%84%E4%BC%B0%E8%AE%A1%E7%AE%97%E4%BF%A1%E6%81%AF) ========================================================================================================================================================================================================================== 描述: 该 API 将给你特定投资品的预估赎回详情。内容包括： * 超级节点名、预估网络费相关； * 接收代币列表、兑换代币详情列表、代币授权状态列表 (包括是否需要授权)； * 可赎回金额、最小赎回数额、最大赎回数额等。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/calculator/redeem-info`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | address | 用户钱包地址 | 请求体 | 否 | String | | inputTokenAmount | 认购代币数量 | 请求体 | 是 | String | | investmentCategory | 认购类型：(例如，0：默认类型；1：BRC-20) 获取 | 请求体 | 否 | String | | investmentId | 投资品 ID ([这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list)
获取) | 请求体 | 是 | String | | isSingle | 判断是否为单币投资品：是：单币；否：多币 | 请求体 | 否 | Boolean | | outputTokenAddress | 代币智能合约地址 ([这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position)
) | 请求体 | 是 | String | | slippage | 滑点 | 请求体 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | isAllowRedeem | 是否允许赎回 | Boolean | | estimateGasFee | 预估网络费用上限 | String | | isSwapInvest | 是否是兑换投资 | Boolean | | inputCurrencyAmount | 输入币种美元价值 | String | | receiveTokenList | 获得的币种信息列表 | Array\[Struct\] | | \>coinAmount | 币种数量 | String | | \>currencyAmount | 币种美元价值 | String | | \>tokenSymbol | 币种标识 | String | | \>tokenName | 币种名称 | String | | \>tokenAddress | 币种的智能合约地址 | String | | \>tokenPrecision | 币种精确小数位 | String | | \>isBaseToken | 质押代币是否为主网基准代币 | Boolean | | \>network | 币种网络 | String | | \>chainId | 币种的链 ID | String | | \>dataType | 0：利息收益 1：矿币收益 2：手续费 3：奖励金 | String | | swapFromTokenList | 赎回过程代币列表：结构同 investWithTokenList | Array\[Struct\] | | mySupply | 可赎回额度：结构同 investWithTokenList | Struct | | approveStatusList | 币种授权状态列表 | Array\[Struct\] | | \>tokenSymbol | 币种标识 | String | | \>tokenAddress | 币种的智能合约地址 | String | | \>tokenPrecision | 币种精确小数位 | String | | \>isNeedApprove | 是否需要授权 | Boolean | | \>approveAddress | 需要授权的合约地址 | String | | \>network | 币种网络 | String | | \>chainId | 币种的链 ID | String | | \>orderType | 类型透传给 Call data 的参数 (3：买入授权；4：赎回授权；8：进入 Farm；9：离开 Farm) | String | [查询认购的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/calculator/redeem-info' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "address": "0x7f****da", "inputTokenAmount": "1.000000146425127036", "investmentCategory": "0", "investmentId": "21033", "isSingle": false, "outputTokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f", "outputTokenDecimal": "18", "redeemId": "", "slippage": "" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "receiveTokenList": [\ {\ "tokenSymbol": "DAI",\ "tokenName": "Dai Stablecoin",\ "tokenAddress": "0x6b****0f",\ "network": "ETH",\ "chainId": "1",\ "tokenPrecision": "18",\ "isBaseToken": false,\ "coinAmount": "1.000000146425127036",\ "currencyAmount": "0.9993097704396316094231068522159962",\ "dataType": "0"\ }\ ], "swapFromTokenList": [\ {\ "tokenSymbol": "DAI",\ "tokenName": "Dai Stablecoin",\ "tokenAddress": "0x6b****0f",\ "network": "ETH",\ "chainId": "1",\ "tokenPrecision": "18",\ "isBaseToken": false,\ "coinAmount": "1.000000146425127036",\ "currencyAmount": "0.9993097704396316094231068522159962"\ }\ ], "isSwapInvest": false, "estimateGasFee": "276614", "isAllowRedeem": true, "mySupply": { "tokenSymbol": "DAI", "tokenName": "Dai Stablecoin", "tokenAddress": "0x6b****0f", "network": "ETH", "chainId": "1", "tokenPrecision": "18", "isBaseToken": false, "coinAmount": "0", "currencyAmount": "0" }, "inputCurrencyAmount": "0.9993097704396316094231068522159962" } } [查询认购的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) --- # 查询网络列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) 查询网络列表 查询网络列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list#%E6%9F%A5%E8%AF%A2%E7%BD%91%E7%BB%9C%E5%88%97%E8%A1%A8) ======================================================================================================================================================= 描述：如果 network 或 chainId 信息准确无误，则该 API 将提供指定网络或链 ID 的信息。如果参数不存在，则会列出所有支持网络的信息。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET **`https://web3.okx.com/api/v5/defi/explore/network-list`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | network | 网络名称 | 请求参数 | 否 | String | | chainId | 公链 ID | 请求参数 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | symbol | 网络名 | String | | chainId | 链 ID | String | [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/explore/network-list' \ --header 'OK-ACCESS-KEY: 89****53' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": [\ {\ "symbol": "Ethereum",\ "chainId": "1"\ },\ {\ "symbol": "OKTC",\ "chainId": "66"\ },\ {\ "symbol": "BNB Chain",\ "chainId": "56"\ },\ {\ "symbol": "Polygon",\ "chainId": "137"\ },\ {\ "symbol": "Avalanche C",\ "chainId": "43114"\ },\ {\ "symbol": "TRON",\ "chainId": "195"\ },\ {\ "symbol": "Solana",\ "chainId": "501"\ },\ {\ "symbol": "Arbitrum",\ "chainId": "42161"\ },\ {\ "symbol": "Optimism",\ "chainId": "10"\ },\ {\ "symbol": "Fantom",\ "chainId": "250"\ },\ {\ "symbol": "Conflux",\ "chainId": "1030"\ },\ {\ "symbol": "Sui",\ "chainId": "784"\ },\ {\ "symbol": "zkSync Era",\ "chainId": "324"\ },\ {\ "symbol": "Stacks",\ "chainId": "5757"\ },\ {\ "symbol": "BTC",\ "chainId": "0"\ },\ {\ "symbol": "Core",\ "chainId": "1116"\ },\ {\ "symbol": "Mantle",\ "chainId": "5000"\ },\ {\ "symbol": "Base",\ "chainId": "8453"\ },\ {\ "symbol": "Polygon zkEVM",\ "chainId": "1101"\ }\ ] } [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) --- # 取消限价单 calldata | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 取消限价单 calldata 取消限价单 calldata[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel#%E5%8F%96%E6%B6%88%E9%99%90%E4%BB%B7%E5%8D%95-calldata) ==================================================================================================================================================== 获取 DEX 限价单取消订单 calldata。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/dex/aggregator/limit-order/cancel/calldata` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数 | 类型 | 必传 | 描述 | | --- | --- | --- | --- | | orderHash | String | 是 | 订单 hash | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数 | 类型 | 描述 | | --- | --- | --- | | data | string | 取消上链 calldata 数据 | [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/dex/aggregator/limit-order/cancel/calldata?orderhash=xxxxxx' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": "0xe2cf089e0000000000000000000000000000000000000000000000000000018c43b2a04000000000000000000000000053e0bca35ec356bd5dddfebbd1fc0fd03fabad390000000000000000000000002791bca1f2de4661ed88a30c99a7a9449aa84174000000000000000000000000c171a1caa36b1c9e2c56fe71a24ceac127ff5ae4000000000000000000000000c171a1caa36b1c9e2c56fe71a24ceac127ff5ae400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001d15c50616925b800000000000000000000000000000000000000000000000000000000002160ec00000000000000000000000000000000000000000000000000000000002160ec00000000000000000000000000000000000000000000000000000018c524f31b80000000000000000000000000000000000000000000000000000000000010001", "msg": "" } [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) --- # 查询产品列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) 查询产品列表 查询产品列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list#%E6%9F%A5%E8%AF%A2%E4%BA%A7%E5%93%81%E5%88%97%E8%A1%A8) ======================================================================================================================================================= 描述：当你输入搜索条件后，该 API 将提供指定条件的可分页投资品列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/explore/product/list`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | simplifyInvestType | 查询投资品类型 (100：稳定币；101：单币赚币；102；多币赚币；103：机枪池) | 请求体 | 是 | String | | network | 查询网络名称 (从[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list)
获取) | 请求体 | 是 | String | | poolVersion | 区别 V2 和 V3 类型流动池，默认为 V2 | 请求体 | 否 | String | | platformIds | 平台 ID (从[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list)
获取) | 请求体 | 否 | Array\[String\] | | sort | 分类查询 | 请求体 | 否 | Struct | | \>orders | 按订单分类查询 | 请求体 | 否 | Array\[Struct\] | | \>>direction | 排序方向：(升序 - ASC、降序 - DESC) | 请求体 | 否 | String | | \>>property | 结果排序的属性名 (可排序字段：锁仓量 - TVL、APY利率 - RATE) | 请求体 | 否 | String | | tokenIds | 查询币种 ID 列表 (从[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list)
获取) | 请求体 | 否 | Array\[String\] | | offset | 可分页的偏移量 | 请求体 | 否 | String | | limit | 可分页限制 | 请求体 | 是 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | investmentId | 投资品 ID | String | | investmentName | 投资品名称 | String | | chainId | 区块链 ID | String | | rate | 收益率 | String | | investType | 投资品类型：1. 存币；2. 流动性池；3. 挖矿；4. 机枪池；5. 质押 | String | | platformName | 平台名称 | String | | platformId | 平台 ID | String | | rateType | 收益率计算类型：0：APY；1：APR | String | | tvl | 总锁定价值 | String | | underlyingToken | 质押代币 | Struct | | \>isBaseToken | 质押代币是否为主网基准代币 | Boolean | | \>tokenContract | 质押代币的智能合约地址 | String | | \>tokenSymbol | 质押代币标识 | String | | total | 查询条件总数 | String | [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/explore/product/list' \ --header 'OK-ACCESS-KEY: 4b****53' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "network":"ETH", "offset":"0", "limit":"10", "sort": { "orders":[\ {\ "direction":"DESC",\ "property":"TVL"\ }\ ] }, "platformIds": ["89"] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "investments": [\ {\ "investmentId": "21033",\ "investmentName": "DAI",\ "chainId": "1",\ "rate": "0.04879",\ "investType": "4",\ "platformName": "MakerDAO",\ "platformId": "89",\ "poolVersion": "1",\ "rateType": "0",\ "tvl": "1211124903.92264",\ "underlyingToken": [\ {\ "tokenSymbol": "DAI",\ "tokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",\ "isBaseToken": false\ }\ ]\ }\ ], "total": "1" } } [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) --- # 取消订单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) 取消订单 取消订单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders#%E5%8F%96%E6%B6%88%E8%AE%A2%E5%8D%95) ===================================================================================================================== 该接口用于取消指定的订单。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/markets/cancel-listing` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | walletAddress | String | 是 | 挂单的钱包地址 | | orderIds | List | 是 | 订单 Id 集合 | [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X POST "https://web3.okx.com/api/v5/mktplace/nft/markets/cancel-listing" \ -H "Content-Type: application/json" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d '{ "chain": "polygon", "walletAddress": "0xb0295f8ed896413eecc1032b9f97ecc8608c55ad", "orderIds": ["3401683780"] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "errors": [], "steps": [\ {\ "action": "CancelOrders",\ "items": [\ {\ "chain": 137,\ "contractAddress": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc",\ "description": "",\ "input": "0xfd9f1e100000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000003f272ad1ce36553bd42b924a85610b7a8cb934530000000000000000000000002de95b9afd737b0814e5e6013593a9437c5532d500000000000000000000000000000000000000000000000000000000000001600000000000000000000000000000000000000000000000000000000000000220000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000658bc374000000000000000000000000000000000000000000000000000000006594fdf3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000030c67a1f49e41a370000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000056423a158caceee70e85222d25675d14d67f474b00000000000000000000000000000000000000000000000000000000000005470000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b1a2bc2ec5000000000000000000000000000000000000000000000000000000b1a2bc2ec5000000000000000000000000000003f272ad1ce36553bd42b924a85610b7a8cb93453",\ "kind": "transaction",\ "orderIds": [\ "3401683780"\ ],\ "platform": {\ "icon": "https://static.coinall.ltd/cdn/nft/2ffcd699-3e14-4ac3-b6fc-e8e5369ab2fd.png",\ "name": "OKX",\ "source": 4\ },\ "platforms": [\ {\ "icon": "https://static.coinall.ltd/cdn/nft/2ffcd699-3e14-4ac3-b6fc-e8e5369ab2fd.png",\ "name": "OKX",\ "source": 4\ }\ ],\ "status": "incomplete",\ "totalPrice": "0",\ "totalUsdPrice": "0",\ "value": "0"\ }\ ]\ }\ ] }, "msg": "" } [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) --- # 查询限价单列表 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 查询限价单列表 查询限价单列表[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all#%E6%9F%A5%E8%AF%A2%E9%99%90%E4%BB%B7%E5%8D%95%E5%88%97%E8%A1%A8) =================================================================================================================================================== 查询 DEX 限价单列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/dex/aggregator/limit-order/all` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数 | 类型 | 必传 | 描述 | | --- | --- | --- | --- | | chainId | String | 是 | 链 ID (如`1`: Ethereum，更多可查看[链 ID 列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks)
) | | page | String | 否 | 页码数(默认: `1`) | | limit | String | 否 | 每页条数 (默认: `100`, 最大: `500`) | | statuses | String | 否 | 用于筛选限价订单的状态数组。状态包括 1 - 有效订单，2 - 暂时失效订单，3 - 被占用订单（正在上链），4 - 过期，5 - 取消，6 - 成功， 7 - 失败订单。 | | takerAsset | String | 否 | 指定成交钱包地址 | | makerAsset | String | 否 | 用户下单钱包地址 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数 | 类型 | 描述 | | --- | --- | --- | | chainId | string | 链 ID (如`1`: Ethereum，更多可查看[链 ID 列表](https://web3.okx.com/zh-hans/web3/build/docs/waas/wallet-supported-networks)
) | | createTime | string | 订单创建时间 | | expireTime | string | 订单过期时间 | | makerAssetAddress | string | 创建订单的钱包地址 | | makerRate | string | takingAmount/makingAmount | | makerTokenAddress | string | 卖出币种合约地址 | | makingAmount | string | 卖出币数量 | | orderHash | string | 签名订单hash | | receiver | string | 默认情况下是零地址，接受者资产将被发送到限价订单创建者的地址。如果您设置了一个值，资产将会发送到当前的地址 | | remainingMakerAmount | string | 剩余可交易数量 | | salt | string | 随机数盐，作为幂等标识
当前时间戳 (秒值) | | signature | string | 钱包签名后的数据 | | status | string | 订单状态 (`0`:可用，`1`:暂时失效，`3`:不可用，`4`订单已全部成交 ) | | takerTokenAddress | string | 买入币种合约地址 | | takingAmount | string | 买入币数量 | | takerRate | string | makingAmount/takingAmount | | takerAssetAddress | string | 默认情况下是零地址，每个人都可以与当前限价订单成交。如果您设置了一个值，则限价订单将仅可在指定地址执行 | [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/dex/aggregator/limit-order/all?chainId=137' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data":[\ {\ "chainId": "137",\ "createTime": "2023-12-07 17:54:20",\ "expireTime": "2023-12-10 13:59:31",\ "makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",\ "makerRate": "16.700084079252467628",\ "makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",\ "makingAmount": "2.095797831550000000",\ "orderHash": "0x618d6abcde06366ae5bd70e8fc661443bd7f9da5073305b39273f1b426cda443",\ "receiver": "",\ "remainingMakerAmount": "2.095797831550000000",\ "salt": "1701942829",\ "signature": "0x867ad0143a04bbee935fde6fcd2a4ddb6cf734a0c6d59352cd5d769d366caf2b25f4480e83d4e9b31274314ec24b88b04686c4df0ad4658b898fd56d630c049e1b",\ "status": "3",\ "takerAssetAddress": "0x0000000000000000000000000000000000000000",\ "takerRate": "0.059879938044285714",\ "takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",\ "takingAmount": "35.000000000000000000"\ },\ {\ "chainId": "137",\ "createTime": "2023-11-09 16:54:40",\ "expireTime": "2023-11-15 21:30:49",\ "makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",\ "makerRate": "17.142857142857142857",\ "makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",\ "makingAmount": "0.700000000000000000",\ "orderHash": "0xf834d285a8bee9c4edf2d3de4acff5acbc350bafe81d0491fc2448d6122a98ee",\ "receiver": "0x0a0de421eb2d6cbef3b81a9d5561f6d2f26c3d07",\ "remainingMakerAmount": "0.000000000000000000",\ "salt": "1699520029",\ "signature": "0xe028369231a0c7d8224c68001bdf16fcdbd3a92ca05d3f50fc880b6688c0980626dc4ac76c5c25276a0197a0db92fd358959d231e31d6eb78488bf34f709edbc1c",\ "status": "3",\ "takerAssetAddress": "0x0000000000000000000000000000000000000000",\ "takerRate": "0.058333333333333333",\ "takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",\ "takingAmount": "12.000000000000000000"\ },\ {\ "chainId": "137",\ "createTime": "2023-12-06 11:17:01",\ "expireTime": "2023-12-20 10:36:05",\ "makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",\ "makerRate": "16.700084079252467628",\ "makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",\ "makingAmount": "2.095797831550000000",\ "orderHash": "0xe1cb49dad5d3b23585c9f99cd75d10a87be70b7f59aa92e04fc5f1fa9023f93c",\ "receiver": "",\ "remainingMakerAmount": "2.095797831550000000",\ "salt": "1701832383",\ "signature": "0x6880a1c3b7c05d1a1c027494512090390789ebae7211ba5a087fe29161394b9320f6ac4eee14ce404902743668d6d1a50170c3c906d47fe0fdcec45a25b111a71b",\ "status": "3",\ "takerAssetAddress": "0x0000000000000000000000000000000000000000",\ "takerRate": "0.059879938044285714",\ "takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",\ "takingAmount": "35.000000000000000000"\ },\ {\ "chainId": "137",\ "createTime": "2023-12-07 16:02:14",\ "expireTime": "2023-12-10 13:59:31",\ "makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",\ "makerRate": "16.700084079252467628",\ "makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",\ "makingAmount": "2.095797831550000000",\ "orderHash": "0x555199460dea70eed738b4e782929c8e1e02f9abfaea31494ce90ba300306292",\ "receiver": "",\ "remainingMakerAmount": "2.095797831550000000",\ "salt": "1701936038",\ "signature": "0x7b00c8b608cb9769c37825f41248d4e5b1502ee705c4255b5074f544482177724a7227daed6cd7acb199e2a46436dc76e71ee16d5c751bd4eb8d2d65e18b7ae21c",\ "status": "3",\ "takerAssetAddress": "0x0000000000000000000000000000000000000000",\ "takerRate": "0.059879938044285714",\ "takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",\ "takingAmount": "35.000000000000000000"\ },\ {\ "chainId": "137",\ "createTime": "2023-12-07 17:18:00",\ "expireTime": "2023-12-10 13:59:31",\ "makerAssetAddress": "0xc171a1caa36b1c9e2c56fe71a24ceac127ff5ae4",\ "makerRate": "16.700084079252467628",\ "makerTokenAddress": "0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39",\ "makingAmount": "2.095797831550000000",\ "orderHash": "0x596d7bd82d82d9766154f9c1884963c06a8d4d26991cd7f9b2448cbdde750a27",\ "receiver": "",\ "remainingMakerAmount": "2.095797831550000000",\ "salt": "1701940627",\ "signature": "0x8185c0bc38ee22ac6cfd9eee078f0526b47c2b31d31f5fdaaa66b8c1ddef930960a1206939fcbf9074471bdeb0fe4875e313616e838ba378096fef6e8fb408491c",\ "status": "3",\ "takerAssetAddress": "0x0000000000000000000000000000000000000000",\ "takerRate": "0.059879938044285714",\ "takerTokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",\ "takingAmount": "35.000000000000000000"\ }\ ], "msg": "" } [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) --- # 查询代币列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) 查询代币列表 查询代币列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list#%E6%9F%A5%E8%AF%A2%E4%BB%A3%E5%B8%81%E5%88%97%E8%A1%A8) ===================================================================================================================================================== 描述：如果 tokenAddress 和 chainId 信息准确无误，则该 API 将提供指定代币的信息。如果参数不存在，则会列出所有代币的信息。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET **`https://web3.okx.com/api/v5/defi/explore/token/list`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | tokenAddress | 币种合约地址 | 请求参数 | 否 | String | | chainId | 币种公链 ID | 请求参数 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | symbol | 平台 ID | String | | tokenInfos | 币种信息 | Array\[Struct\] | | \>tokenId | 币种 ID | String | | \>tokenSymbol | 币种标识 | String | | \>network | 币种网络名称 | String | | \>logoUrl | 币种 logo 网址 | String | | \>tokenAddress | 币种智能合约地址 | String | [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/explore/token/list' \ --header 'OK-ACCESS-KEY: 24b****53' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": [\ {\ "symbol": "oSQTH",\ "tokenInfos": [\ {\ "tokenId": "7042",\ "tokenSymbol": "oSQTH",\ "network": "ETH",\ "logoUrl": "https://static.coinall.ltd/cdn/wallet/logo/icon_unknow.png",\ "tokenAddress": "0xf1b99e3e573a1a9c5e6b2ce818b617f0e664e86b"\ }\ ]\ },\ {\ "symbol": "DFI",\ "tokenInfos": [\ {\ "tokenId": "3533",\ "tokenSymbol": "DFI",\ "network": "ETH",\ "logoUrl": "https://static.coinall.ltd/cdn/wallet/logo/icon_custom_default_D.png",\ "tokenAddress": "0x8fc8f8269ebca376d046ce292dc7eac40c8d358a"\ },\ {\ "tokenId": "8645",\ "tokenSymbol": "DFI",\ "network": "BSC",\ "logoUrl": "https://static.coinall.ltd/cdn/wallet/logo/icon_custom_default_D.png",\ "tokenAddress": "0x361c60b7c2828fcab80988d00d1d542c83387b50"\ }\ ]\ }\ ] } [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) --- # 获取合集交易信息 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) 获取合集交易信息 获取合集交易信息[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history#%E8%8E%B7%E5%8F%96%E5%90%88%E9%9B%86%E4%BA%A4%E6%98%93%E4%BF%A1%E6%81%AF) ============================================================================================================================================================================ 此 API 用于获取 NFT 销售历史信息，如收藏地址，平台，价格，买家和卖家。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/markets/trades` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | 是 | String | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | collectionAddress | 是 | String | 合集的合同地址 | | platform | 否 | String | 目标挂单平台，详情见[已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets)
，默认值为所有平台 | | limit | 否 | String | 每页记录数。最大为 50，最小为1。如果输入大于50或者没有输入，那么就会默认为50。 | | tokenId | 否 | String | NFT 的 Token ID。如果为空，它将查询所有 NFT 的 Token ID。 | | cursor | 否 | String | 指向要检索的页面的游标。 | | startTime | 否 | String | 要查询的销售历史记录的起始时间范围。 | | endTime | 否 | String | 要从中查询的销售历史记录的结束时间范围。 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | **参数** | **类型** | **描述** | | --- | --- | --- | | cursor | String | 指向要检索的页面的游标。将此游标用作下一个查询的输入 | | amount | Integer | 此交易历史中交易的 NFT 数量 | | chain | String | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | collectionAddress | String | 合集的合同地址 | | currencyAddress | String | 此交易的支付地址 | | from | String | 卖家地址 | | to | String | 买家地址 | | platform | String | 目标挂单平台，详情见[已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets)
，默认值为所有平台 | | price | BigDecimal | 每个 NFT 的价格 | | timestamp | Long | 交易时间戳 | | tokenId | String | NFT 的 Token ID | | txHash | String | 交易的 Hash | [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://beta.okex.org/api/v5/mktplace/nft/markets/trades?chain=ethereum&collectionAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d' \ --header 'OK-ACCESS-KEY: your api access key' \ --header 'OK-ACCESS-PASSPHRASE: your api passphrase' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "MTcxOTk0NDQ0NzoweDRiYjNhZjY1MDQwOTdkMjBkY2QxMzAxZDg0NTdjOGVkNzEzMzQ3OGY2NjFiODdhN2M4YzdlNTk4OTIxMjcwNDktMTU4", "data": [\ {\ "amount": 1,\ "chain": "Ethereum",\ "collectionAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "currencyAddress": "0x0000000000000000000000000000000000000000",\ "from": "0xf15c93562bc3944a68e938ef75d2a3360d98ca57",\ "platform": "Blur",\ "price": 9.71,\ "timestamp": 1720113467,\ "to": "0xeb0abe3e9f38fc74ed900f118744275af3a99618",\ "tokenId": "4382",\ "txHash": "0x11b30e98235053d2749a41249db60c895ca8bac1942b526a993f3c4be058a0b4"\ },\ {\ "amount": 1,\ "chain": "Ethereum",\ "collectionAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "currencyAddress": "0x0000000000a39bb272e79075ade125fd351887ac",\ "from": "0x29469395eaf6f95920e59f858042f0e28d98a20b",\ "platform": "Blur",\ "price": 9.45,\ "timestamp": 1720110203,\ "to": "0x0f2bbce1fcb6702a4d9ab30e5c68868f82af3d41",\ "tokenId": "3854",\ "txHash": "0xe34400d02d0330cd7b4cbbdd3d2d2e458e4fd702ef768ab6de73591bc2060906"\ }\ ], "next": true, "total": 10000 }, "msg": "" } [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) --- # 查询用户的余额列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) 查询用户的余额列表 查询用户的余额列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance#%E6%9F%A5%E8%AF%A2%E7%94%A8%E6%88%B7%E7%9A%84%E4%BD%99%E9%A2%9D%E5%88%97%E8%A1%A8) ======================================================================================================================================================================================= 描述：该 API 将提供用户的余额列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/user/balance-list`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | chainId | 公链 ID | 请求体 | 是 | String | | address | 用户钱包地址 | 请求体 | 是 | String | | tokenAddressList | 代币智能合约列表 (主网币合约地址需要提前约定) | 请求体 | 是 | Array\[String\] | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | tokenSymbol | 币种标识 | String | | tokenName | 币种名称 | String | | tokenLogo | 币种 logo 网址 | String | | tokenAddress | 币种合约地址 | String | | network | 币种网络 | String | | chainId | 链 ID | String | | tokenPrecision | 币种精度 | String | | isBaseToken | 是否是主网代币 | Boolean | | coinAmount | 币种数量 | String | | currencyAmount | 币种数量美元价值 | String | | browserUrl | 币种 OKLink 网址 | String | [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/user/balance-list' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "chainId": "1", "address": "0xa0****48", "tokenAddressList": [\ "0x6b175474e89094c44da98b954eedeac495271d0f",\ "0xdac17f958d2ee523a2206206994597c13d831ec7"\ ] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": [\ {\ "tokenSymbol": "DAI",\ "tokenName": "Dai Stablecoin",\ "tokenLogo": "https://static.coinall.ltd/cdn/wallet/logo/icon_custom_default_D.png",\ "tokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",\ "network": "ETH",\ "chainId": "1",\ "tokenPrecision": "18",\ "isBaseToken": false,\ "coinAmount": "4.309755677978655097",\ "currencyAmount": "4.310735082243589184287938931547",\ "browserUrl": "https://www.oklink.com/eth/token/0x6b175474e89094c44da98b954eedeac495271d0f"\ },\ {\ "tokenSymbol": "USDT",\ "tokenName": "Tether USD",\ "tokenLogo": "https://static.coinall.ltd/cdn/wallet/logo/icon_custom_default_U.png",\ "tokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",\ "network": "ETH",\ "chainId": "1",\ "tokenPrecision": "6",\ "isBaseToken": false,\ "coinAmount": "43.628705",\ "currencyAmount": "43.644922800365259359125",\ "browserUrl": "https://www.oklink.com/eth/token/0xdac17f958d2ee523a2206206994597c13d831ec7"\ }\ ] } [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) --- # 查询产品详情 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) 查询产品详情 查询产品详情[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details#%E6%9F%A5%E8%AF%A2%E4%BA%A7%E5%93%81%E8%AF%A6%E6%83%85) ========================================================================================================================================================== 描述：当你输入搜索条件后，该 API 将提供指定的投资品详情。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET **`https://web3.okx.com/api/v5/defi/explore/product/detail`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | investmentId | 投资品 ID | 请求参数 | 是 | String | | investmentCategory | 认购类型：(例如，0：默认类型；1：BRC-20） | 请求参数 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | Data type | | --- | --- | --- | | investmentId | 投资品 ID | String | | investmentName | 投资品名称 | String | | chainId | 区块链 ID | String | | rate | 收益率 | String | | investType | 投资品类型：1. 存币；2. 流动性池；3. 挖矿；4. 机枪池；5. 质押 | String | | platformName | 平台名称 | String | | platformId | 平台 ID | String | | analysisPlatformId | 领取奖励金用平台 ID | String | | rateType | 收益率计算类型：0：APY；1：APR | String | | tvl | TVL | String | | underlyingToken | 质押代币 | Struct | | \>isBaseToken | 质押代币是否为主网基准代币 | Boolean | | \>tokenContract | 质押代币的智能合约地址 | String | | \>tokenSymbol | 质押代币标识 | String | | isInvestable | 是否可投资 | String | | utilizationRate | 使用的汇率 | String | | earnedToken | 已获代币 | Struct | | \>isBaseToken | 质押代币是否为主网基准代币 | Boolean | | \>tokenContract | 质押代币的智能合约地址 | String | | \>tokenSymbol | 质押代币标识 | String | | lpToken | LP 代币 | Struct | | \>isBaseToken | 质押代币是否为主网基准代币 | Boolean | | \>tokenContract | 质押代币的智能合约地址 | String | | \>tokenSymbol | 质押代币标识 | String | [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/explore/product/detail?investmentId=21010' \ --header 'OK-ACCESS-KEY: 4b****53' \ --header 'OK-ACCESS-PASSPHRASE: p****d' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "investmentId": "120", "investmentName": "jEUR", "chainId": "137", "rate": "0.01129", "investType": "1", "platformName": "Aave V3", "platformId": "24", "analysisPlatformId": "10", "rateType": "0", "tvl": "51350.92499", "underlyingToken": [\ {\ "tokenSymbol": "jEUR",\ "tokenAddress": "0x4e3decbb3645551b8a19f0ea1678079fcb33fb4c",\ "isBaseToken": false\ }\ ], "isInvestable": false, "earnedToken": [\ {\ "tokenSymbol": "jEUR",\ "tokenAddress": "0x4e3decbb3645551b8a19f0ea1678079fcb33fb4c",\ "isBaseToken": false\ }\ ], "lpToken": [\ {\ "tokenSymbol": "aPolJEUR",\ "tokenAddress": "0x6533afac2e7bccb20dca161449a13a32d391fb00",\ "isBaseToken": false\ }\ ], "utilizationRate": "0.76862" } } [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) --- # 查询特定代币 | 账户维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-account) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) 查询特定代币 查询特定代币[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances#%E6%9F%A5%E8%AF%A2%E7%89%B9%E5%AE%9A%E4%BB%A3%E5%B8%81) ============================================================================================================================================ 查询钱包账户下某些指定代币的余额。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/asset/token-balances` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | accountId | String | Yes | 账户唯一标识 | | tokenAddresses | Array | Yes | 代币列表。列表的上限是20 | | \>chainIndex | String | Yes | 链唯一标识 | | \>tokenAddress | String | Yes | 代币地址。
`1`：传""代表查询对应链的主链币。
`2`：传具体的代币合约地址，代表查询对应的代币。
`3`：不同铭文代币按如下格式入参：
`FBRC-20`: 使用 `fbtc_fbrc20_name`，如 fbtc\_fbrc20\_babymusk
`BRC-20`: 使用 `btc-brc20-tick(name)`，如 btc-brc20-ordi
`Runes`: 使用 `btc-runesMain-tickId`，如 btc-runesMain-840000:2
`SRC-20`:使用 `btc-src20-name`，如 btc-src20-utxo | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | tokenAssets | Array | 代币余额列表 | | \>chainIndex | String | 链唯一标识 | | \>tokenAddress | String | 代币地址。为空 "" 代表返回结果是相关链，主链币的数据 | | \>symbol | String | 代币简称 | | \>balance | String | 代币数量 | | \>rawBalance | String | 代币的原始数量。更多的链即将被支持。对于不支持的链，该字段为空 | | \>tokenPrice | String | 币种单价价值，以美元计价 | | \>tokenType | String | 币种类型:
`1`：token
`2`：铭文 | | \>isRiskToken | Boolean | `true`: 命中风险空投币
`false`: 未命中风险空投币 | [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/asset/token-balances' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "accountId": "4686531e-3adb-469a-8000-8fd1c2097f68", "tokenAddresses": [\ {\ "chainIndex": "1",\ "tokenAddress": ""\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-brc20-psat"\ }\ ] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-token-balances#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "tokenAssets": [\ {\ "chainIndex": "1",\ "tokenAddress": "",\ "symbol": "ETH",\ "balance": "0.07210371955388872",\ "rawBalance": "",\ "tokenPrice": "2650.43",\ "tokenType": "1",\ "isRiskToken": false\ },\ {\ "chainIndex": "0",\ "tokenAddress": "btc-brc20-psat",\ "symbol": "psat",\ "balance": "1",\ "rawBalance": "",\ "tokenPrice": "140",\ "tokenType": "2",\ "isRiskToken": false\ }\ ]\ }\ ] } [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-wallet-all-token-balances) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) * * * --- # 获取铭文资产列表 | 创建 Ordinals 挂单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) 获取铭文资产列表 获取铭文资产列表[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions#%E8%8E%B7%E5%8F%96%E9%93%AD%E6%96%87%E8%B5%84%E4%BA%A7%E5%88%97%E8%A1%A8) ========================================================================================================================================================================= 该接口用于获取指定地址上的 BTC NFT 和 BRC-20 合集的铭文资产，包括铭文数量，币种和 NFT ID。默认按照成交时间倒序。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/ordinals/get-valid-inscriptions` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 是 | 合集 slug 名称，即合集的唯一标识 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小 (默认值 10，最大 100)。返回最大的合集数 | | sort | String | 否 | 挂单排序规则：listing\_time\_desc：订单创建时间最新的在前 listing\_time\_asc：订单创建时间最早的在前 price\_desc：价格最高的在前 price\_asc：价格最低的在前 unit\_price\_desc：单价最高的在前 unit\_price\_asc：单价最低的在前 默认排序为订单创建时间最新的在前 | | isBrc20 | Boolean | 否 | 获取全部 BTC NFT 或 BRC-20 合集的列表，默认为 BRC-20 | | walletAddress | String | 是 | 获取铭文的钱包地址 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 铭文数据的列表 | **参数** | **类型** | **描述** | | --- | --- | --- | | inscriptionId | String | 铭文 ID | | cursor | String | 现在指向的游标 | | nftId | String | 铭文 NFT ID 是唯一标识 | | ticker | String | 币种 | | tickerId | String | 币种的 ID | | amount | String | 铭文数量 | [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) ### 代码请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions#%E4%BB%A3%E7%A0%81%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/mktplace/nft/ordinals/get-valid-inscriptions' \ --header 'OK-ACCESS-KEY: your API key' \ --header 'OK-ACCESS-PASSPHRASE: your passphrase' \ --header 'Content-Type: application/json' \ --data '{ "slug": "BTC Ordinals", "walletAddress": "bc1qek.....27zgdgqfawx", "limit": "10", "isBrc20": false }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "MTY5N.......WZhd3g=", "inscriptionInfos": [\ {\ "amount": "1",\ "inscriptionId": "6218a48de6039b1e...fdce171601083961f45a326856dd30ffi0",\ "nftId": "208249...3273458",\ "ticker": "",\ "tickerId": ""\ },\ {\ "amount": "1",\ "inscriptionId": "caf70bcc595389...a1ccb4ec81fa0a0612a95f2e8402a10710a373i0",\ "nftId": "20793046...2400114",\ "ticker": "",\ "tickerId": ""\ },\ {\ "amount": "1",\ "inscriptionId": "ad14bd7fa6afee2bc37681f6...9b949746d258e0c8133c259a94198febf66bi0",\ "nftId": "17407619...517490",\ "ticker": "",\ "tickerId": ""\ },\ {\ "amount": "1",\ "inscriptionId": "6f776f43d119094...37ce8abab7aea902a4455fc7b8b319122880f71a1ci0",\ "nftId": "16635...80929138",\ "ticker": "",\ "tickerId": ""\ },\ {\ "amount": "1",\ "inscriptionId": "e0ae7e1ee159...d836fe692b1fb6b25911f9f6edec666da9fb090fdffe4i0",\ "nftId": "166355152...29586",\ "ticker": "",\ "tickerId": ""\ }\ ] }, "msg": "" } [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) --- # 地址校验 | 获取交易信息 | 交易广播 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) [签名所需数据](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sign-info) [Gas Price](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-price) [Gas Limit](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-gas-limit) [Nonce](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-nonce) [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [地址校验](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) [查广播订单列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-order-id-transaction-list) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [获取交易信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-pre-transaction) 地址校验 地址校验[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address#%E5%9C%B0%E5%9D%80%E6%A0%A1%E9%AA%8C) ========================================================================================================================== 传入地址，判断是否地址格式有效，是否命中黑名单。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/pre-transaction/validate-address` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | address | String | Yes | 地址 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | addressType | String | `0`: 无效的地址格式
`1`: 有效的用户地址
`2`: 有效的合约地址 | | hitBlacklist | Boolean | `false`: 没有命中黑地址
`true`: 命中黑地址 | | tag | String | 黑地址标签类型，包括貔貅盘、网络钓鱼以及合约漏洞等类型。`已废弃` | [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/pre-transaction/validate-address?chainIndex=1&address=0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2&addressType=0' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-validate-address#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "addressType": "1"\ "hitBlacklist":"true"\ "tag":"HoneyPot"\ }\ ], "msg": "success" } [SUI Object](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-sui-object) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-send-transaction) * * * --- # 查询限价单 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 查询限价单 查询限价单[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order#%E6%9F%A5%E8%AF%A2%E9%99%90%E4%BB%B7%E5%8D%95) =========================================================================================================================== 查询 DEX 限价单状态。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/dex/aggregator/limit-order/detail` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数 | 类型 | 必传 | 描述 | | --- | --- | --- | --- | | orderHash | String | 是 | 签名后数据 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数 | 类型 | 描述 | | --- | --- | --- | | createTime | string | 订单创建时间 | | expireTime | string | 当前订单生效截止时间 | | failureReason | string | 错误信息 (如果有) | | orderHash | string | 签名后数据 | | signature | string | 钱包签名后的数据 | | chainId | string | 链 ID (如`1`: Ethereum，更多可查看[链 ID 列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks)
) | | makerAssetAddress | string | 创建订单的钱包地址 | | makerTokenAddress | string | 卖出币种合约地址 | | makingAmount | string | 卖出币数量 | | takerTokenAddress | string | 买入币种合约地址 | | takingAmount | string | 买入币数量 | | makerRate | string | takingAmount/makingAmount | | takerRate | string | makingAmount/takingAmount | | receiver | string | 默认情况下是零地址，接受者资产将被发送到限价订单创建者的地址。如果您设置了一个值，资产将会发送到当前的地址 | | remainingMakerAmount | string | 剩余可交易数量 | | salt | string | 随机数盐，作为幂等标识
当前时间戳 (秒值) | | status | string | 订单状态 (1 - 有效订单，2 - 暂时失效订单，3 - 被占用订单（正在上链)，4 - 过期，5 - 取消，6 - 成功， 7 - 失败。） | | takerAssetAddress | string | 默认情况下是零地址，每个人都可以与当前限价订单成交。如果您设置了一个值，则限价订单将仅可在指定地址执行 | [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/dex/aggregator/limit-order/detail?orderHash=0xf1852a5c82b9ff8919aaacce31325f4a778603471c2e8fa8d80583824c21e97a' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code":"0", "data":{ "createTime":"2023-10-13 14:22:47", "chainId":"137", "makerAssetAddress":"0xc171a1caA36b1c9e2C56fE71A24cEAC127FF5ae4", "makerRate":"2.000000000000000000", "makerTokenAddress":"0x2791bca1f2de4661ed88a30c99a7a9449aa84174", "makingAmount":"3.000000000000000000", "takingAmount":"6.000000000000000000", "receiver":"", "remainingMakerAmount":"2.500000000000000000", "salt":"1697032618", "status":"1", "takerAssetAddress":"0x0000000000000000000000000000000000000000", "takerRate":"0.5", "takerTokenAddress":"0xc2132d05d31c914a87c6611c10748aeb04b58e8f" "expireTime":"2023-10-20 14:41:00", "failureReason":"", "orderHash":"0xf1852a5c82b9ff8919aaacce31325f4a778603471c2e8fa8d80583824c21e97a", "signature":"0x78645ba7ed8c0266e01e46302160aad94537dbac9a0c751b9c315a516f44f54765acd11c11ffc88c9dd7f74fa63c606506ab145f94592bbbcb3cf2bac1cb13a01b" }, "msg":"" } [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) --- # 查询特定代币 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) 查询特定代币 查询特定代币[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address#%E6%9F%A5%E8%AF%A2%E7%89%B9%E5%AE%9A%E4%BB%A3%E5%B8%81) =============================================================================================================================================================== 查询地址下指定代币的余额。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/asset/token-balances-by-address` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | address | String | Yes | 地址 | | tokenAddresses | Array | Yes | 代币合约地址列表，查询指定代币余额。上限是 20 | | \>chainIndex | String | Yes | 链唯一标识 | | \>tokenAddress | String | Yes | 代币地址。
`1`：传""代表查询对应链的主链币。
`2`：传具体的代币合约地址，代表查询对应的代币。
`3`：不同铭文代币按如下格式入参：
`FBRC-20`: 使用 `fbtc_fbrc20_name`，如 fbtc\_fbrc20\_babymusk
`BRC-20`: 使用 `btc-brc20-tick(name)`，如 btc-brc20-ordi
`Runes`: 使用 `btc-runesMain-tickId`，如 btc-runesMain-840000:2
`SRC-20`:使用 `btc-src20-name`，如 btc-src20-utxo | | filter | String | No | `0`: 过滤风险空投币
`1`: 不过滤风险空投币
默认过滤 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | tokenAssets | Array | 代币余额列表 | | \>chainIndex | String | 链唯一标识 | | \>tokenAddress | String | 代币地址。为空 "" 代表返回结果是相关链，主链币的数据 | | \>address | String | 地址 | | \>symbol | String | 代币简称 | | \>balance | String | 代币数量 | | \>rawBalance | String | 代币的原始数量。更多的链即将被支持。对于不支持的链，该字段为空。 | | \>tokenPrice | String | 币种单价价值，以美元计价 | | \>tokenType | String | 代币类型:
`1`：token
`2`：铭文 | | \>transferAmount | String | BRC-20、FBRC-20 等铭文资产可直接转账、交易的余额数量，一般称为可转余额。 | | \>availableAmount | String | BRC-20、FBRC-20 等铭文资产需要完成铭刻操作才可以交易、转账的数量，一般称为可用余额或者待铭刻余额。 | | \>isRiskToken | Boolean | `true`: 命中风险空投币
`false`: 未命中风险空投币 | [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/asset/token-balances-by-address' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ "address":"0x50c476a139aab23fdaf9bca12614cdd54a4244e3", "tokenAddresses": [\ {\ "chainIndex": "1",\ "tokenAddress": ""\ }\ ] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "tokenAssets": [\ {\ "chainIndex": "1",\ "tokenAddress": "",\ "symbol": "eth",\ "balance": "0",\ "tokenPrice": "3640.43",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": ""\ }\ ]\ }\ ] } [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) --- # 生成申购交易的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) 生成申购交易的调用数据 生成申购交易的调用数据[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E7%94%9F%E6%88%90%E7%94%B3%E8%B4%AD%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) ========================================================================================================================================================================================================================== 描述：该 API 将提供申购交易的调用数据。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/transaction/subscription`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | address | 用户钱包地址 | 请求体 | 是 | String | | investmentId | 投资品 ID | 请求体 | 是 | String | | userInputList | 用户输入代币信息 | 请求体 | 是 | Array\[Struct\] | | \>chainId | 区块链 ID (默认：投资品网络) | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 是 | String | | \>tokenAddress | 认购代币的智能合约地址 (默认：投资品代币地址) | 请求体 | 否 | String | | expectOutputLIst | 用户预期收益信息 | 请求体 | 是 | Array\[Struct\] | | \>chainId | 区块链 ID | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 是 | String | | \>tokenAddress | 认购代币的智能合约地址 | 请求体 | 否 | String | | extra | 具体含义见备注 | 请求体 | 否 | String | ### 备注：[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E5%A4%87%E6%B3%A8%EF%BC%9A) extra 用法 申购 key：rewardAddress (String) 含义：STX 质押类投资品，用户个人获得 BTC 奖励钱包地址 ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | dataList | Call data 数据信息 | Array\[Struct\] | | \>from | 发送地址 (用户地址) | String | | \>to | 接受地址 (目标合约地址) | String | | \>value | 转账金额 (原生代币数量，默认为空字符串) | String | | \>serializedData | Call data 数据 | String | | \>originalData | 原始数据 (JSON) | JSON String | | \>callDataType | 操作类型 (授权、申购、赎回、领取) | String | | \>signatureData | 签名 Call data 数据信息，可用于验证数据由欧易生成 | String | ### 备注：[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E5%A4%87%E6%B3%A8%EF%BC%9A) 验签方法： 1. 使用 signatureData 签名信息计算出 r、s、v。 2. 与 to + serializedData + originalData 拼接成的字符串计算出验签 hash。 3. 恢复公钥验证。可由接入客户选则是否验签，如果验签成功，则说明该数据由欧易签名生成。 [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) 申购示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E7%94%B3%E8%B4%AD%E7%A4%BA%E4%BE%8B) ---------------------------------------------------------------------------------------------------------------------------------------------------- ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/transaction/subscription' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "address": "0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da", "userInputList": [\ {\ "coinAmount": "0.6"\ }\ ], "expectOutputList": [\ {\ "coinAmount": "0.5"\ }\ ], "investmentId": "6925" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "dataList": [\ {\ "from": "0x7f****da",\ "to": "0x72****d2",\ "value": "0x0",\ "serializedData": "0x016cba5f00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000526a913a7a4518aa2abc3dcd3c46a9c73f40f94a0000000000000000000000000000000000000000000000000853a0d2313c00000000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da9400000000000000000000000000000000000000000000000000000000000000010000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce600000000000000000000000000000000000000000000000006f05b59d3b20000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da94000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e4c41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f700000000000000000000000000000000000000000000000000000000", \ "originalData": "{\"hexCallData\":\"0x016cba5f00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000526a913a7a4518aa2abc3dcd3c46a9c73f40f94a0000000000000000000000000000000000000000000000000853a0d2313c00000000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da9400000000000000000000000000000000000000000000000000000000000000010000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce600000000000000000000000000000000000000000000000006f05b59d3b20000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000005569e13b1ec4336d17e8f24d892a4a915fc5da94000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e4c41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f700000000000000000000000000000000000000000000000000000000\",\"methodDefine\":\"{\\n\\t\\\"inputs\\\": [{\\n\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\\"internalType\\\": \\\"struct TokenInInfo\\\",\\n\\t\\t\\t\\\"name\\\": \\\"tokenIn\\\",\\n\\t\\t\\t\\\"type\\\": \\\"tuple[]\\\",\\n\\t\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"token\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"uint256\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"amount\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"uint256\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"to\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}]\\n\\t\\t}, {\\n\\t\\t\\t\\\"internalType\\\": \\\"struct TokenAmount\\\",\\n\\t\\t\\t\\\"name\\\": \\\"tokenOut\\\",\\n\\t\\t\\t\\\"type\\\": \\\"tuple[]\\\",\\n\\t\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"token\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"uint256\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"amount\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"uint256\\\"\\n\\t\\t\\t}]\\n\\t\\t}],\\n\\t\\t\\\"internalType\\\": \\\"struct BaseRequest\\\",\\n\\t\\t\\\"name\\\": \\\"request\\\",\\n\\t\\t\\\"type\\\": \\\"tuple\\\"\\n\\t}, {\\n\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\\"name\\\": \\\"target\\\",\\n\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t}, {\\n\\t\\t\\t\\\"internalType\\\": \\\"bytes\\\",\\n\\t\\t\\t\\\"name\\\": \\\"callData\\\",\\n\\t\\t\\t\\\"type\\\": \\\"bytes\\\"\\n\\t\\t}],\\n\\t\\t\\\"internalType\\\": \\\"struct Call\\\",\\n\\t\\t\\\"name\\\": \\\"calls\\\",\\n\\t\\t\\\"type\\\": \\\"tuple[]\\\"\\n\\t}],\\n\\t\\\"name\\\": \\\"execute\\\",\\n\\t\\\"stateMutability\\\": \\\"payable\\\",\\n\\t\\\"type\\\": \\\"function\\\"\\n}\",\"methodId\":\"\",\"methodType\":\"ABI\",\"params\":{\"baseRequest\":{\"tokenIn\":[{\"amount\":600000000000000000,\"to\":\"0x5569e13b1ec4336d17e8f24d892a4a915fc5da94\",\"token\":\"0x526a913a7a4518aa2abc3dcd3c46a9c73f40f94a\"}],\"tokenOut\":[{\"amount\":500000000000000000,\"token\":\"0x4e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce6\"}]},\"operatorDataList\":[{\"adapterOperate\":true,\"call\":{\"calls\":\"xBo76AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAATjikrU8hCtWrssjyWYcGrotKHOYAAAAAAAAAAAAAAAB/Qp7e/4r8e7Oiz324MvyG9vqZ2gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAbwW1nTsgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACb3\",\"callsAsString\":\"0xc41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f7\",\"target\":\"0x5569e13b1ec4336d17e8f24d892a4a915fc5da94\"},\"hexCallData\":\"0xc41a3be800000000000000000000000000000000000000000000000000000000000000000000000000000000000000004e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce60000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da00000000000000000000000000000000000000000000000006f05b59d3b2000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000026f7\",\"operateType\":\"DEPOSIT\",\"operatorMethodInfo\":{\"methodDefine\":\"{\\n\\t\\\"inputs\\\": [{\\n\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\\"name\\\": \\\"pool\\\",\\n\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t}, {\\n\\t\\t\\\"internalType\\\": \\\"struct TokenOutInfo\\\",\\n\\t\\t\\\"name\\\": \\\"tokenOut\\\",\\n\\t\\t\\\"type\\\": \\\"tuple\\\",\\n\\t\\t\\\"components\\\": [{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"token\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t}, {\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"address\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"toAddress\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"address\\\"\\n\\t\\t\\t},\\n\\t\\t\\t{\\n\\t\\t\\t\\t\\\"internalType\\\": \\\"uint256\\\",\\n\\t\\t\\t\\t\\\"name\\\": \\\"minAmount\\\",\\n\\t\\t\\t\\t\\\"type\\\": \\\"uint256\\\"\\n\\t\\t\\t}\\n\\t\\t]\\n\\t}, {\\n\\t\\t\\\"internalType\\\": \\\"bytes\\\",\\n\\t\\t\\\"name\\\": \\\"data\\\",\\n\\t\\t\\\"type\\\": \\\"bytes\\\"\\n\\n\\t}],\\n\\t\\\"name\\\": \\\"deposit\\\",\\n\\t\\\"stateMutability\\\": \\\"payable\\\",\\n\\t\\\"type\\\": \\\"function\\\"\\n}\",\"params\":{\"data\":\"00000000000000000000000000000000000000000000000000000000000026f7\",\"pool\":\"0x0000000000000000000000000000000000000000\",\"tokenOut\":{\"amount\":500000000000000000,\"toAddress\":\"0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da\",\"token\":\"0x4e38a4ad4f210ad5abb2c8f2598706ae8b4a1ce6\"}}},\"target\":\"0x5569e13b1ec4336d17e8f24d892a4a915fc5da94\"}]},\"useAdapter\":true}",\ "signatureData": "dbfe682a491b31141c99800913c9a052ee8dee122854cb0c459af85fff9f5d571aaf217b3bbbe10b141247bc0327357c3dde2874333f8a4c031d84d31a41ffec1c"\ }\ ] } } [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) --- # 创建限价单 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 创建限价单 创建限价单[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order#%E5%88%9B%E5%BB%BA%E9%99%90%E4%BB%B7%E5%8D%95) ============================================================================================================================ 创建 DEX 限价单。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/dex/aggregator/limit-order/save-order` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数 | 类型 | 必传 | 描述 | | --- | --- | --- | --- | | orderHash | String | 是 | 订单hash | | signature | String | 是 | 签名 | | chainId | String | 是 | 链 ID (如`1`: Ethereum，更多可查看[链 ID 列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks)
)） | | _**data**_ | _**Object**_ | _**是**_ | _**订单的数据对象**_ | | salt | String | 是 | 随机数盐，作为幂等标识
当前时间戳 (秒值) (如：`1691499249`) | | makingAmount | String | 是 | 卖出币数量
(数量需包含精度，如 `1.00` USDT 需输入 `1000000`， `1.00` DAI 需输入 `1000000000000000000`) | | takingAmount | String | 是 | 买入币数量
(数量需包含精度，如 `1.00` USDT 需输入 `1000000`， `1.00` DAI 需输入 `1000000000000000000`) | | makerToken | String | 是 | 卖出币种合约地址 (如：`0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39`) | | takerToken | String | 是 | 买入币种合约地址 (如：`0x2791bca1f2de4661ed88a30c99a7a9449aa84174`) | | maker | String | 是 | 创建订单的钱包地址 (如：`0x6f9ffea7370310cd0f890dfde5e0e061059dcfd9`) | | deadLine | String | 是 | 当前订单生效截止时间
时间戳 (秒值) (如：`1699520029`) | | allowedSender | String | 是 | 设置零地址 (`0x0000000000000000000000000000000000000000`)，每个人都可以与当前限价订单成交。如果您设置了指定值，则限价订单将仅可在指定地址执行 (如：`0x6f9ffea7370310cd0f890dfde5e0e061059dcfd9`) | | receiver | String | 是 | 资产将会发送到当前receiver的地址 (如：`0x6f9ffea7370310cd0f890dfde5e0e061059dcfd9`) | | minReturn | String | 是 | 买入币最小获得数量
(数量需包含精度，如 `1.00` USDT 需输入 `1000000`， `1.00` DAI 需输入 `1000000000000000000`) | | partiallyAble | Bool | 是 | 是否支持部分成交 (`true` 代表支持， `false` 代表不支持) | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数 | 类型 | 描述 | | --- | --- | --- | | code | String | 状态码 (如`0`: 操作成功，`51000`: 必填参数不能为空， 更多可查看错误码列表) | | msg | String | 服务端响应信息，接口正常无值，异常会返回异常 | [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell { "orderHash":"0xf1852a5c82b9ff891123456731325f4a778603471c2e8fa8d80583824c21e97a", "signature":"0x78645ba7ed8c0266e01e46302160aad1234567ac9a0c751b9c315a516f44f54765acd11c11ffc88c9dd7f74fa63c606506ab145f94592bbbcb3cf2bac1cb13a01b", "chainId":"137", "data":{ "salt":"1697032618", "makingAmount":"5900000", "takingAmount":"6000000", "makerToken":"0x2791bca1f2de4661ed88a30c99a7a9449aa84174", "takerToken":"0xc2132d05d31c914a87c6611c10748aeb04b58e8f", "maker":"0x230293u8238sh823472hjskq92j38ahj2i391k20", "deadLine":"1697784060", "allowedSender":"0x0000000000000000000000000000000000000000", "receiver":"0x230293u8238sh823472hjskq92j38ahj2i391k20", "minReturn":"6000000", "partiallyAble" : true } } ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code":"0", "msg":"save order success" } [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) --- # 订单相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [NFT 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) [资产相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) [合集相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) [订单相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) 订单相关模型 订单相关模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E7%9B%B8%E5%85%B3%E6%A8%A1%E5%9E%8B) ======================================================================================================================================= 订单状态枚举[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E7%8A%B6%E6%80%81%E6%9E%9A%E4%B8%BE) --------------------------------------------------------------------------------------------------------------------------------------- | 枚举 | 描述 | | --- | --- | | active | 表示该订单当前有效，可以被成交 | | inactive | 表示该订单当前暂时失效，在后续可能重新变为 active 状态 | | cancelled | 表示该订单已经被取消，无法被交易 | | sold | 表示该订单已经被成交，无法再次被交易 | 欧易订单模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E6%AC%A7%E6%98%93%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------------------------------------------- 订单返回数据模型模型 | 参数 | 类型 | 描述 | | --- | --- | --- | | orderId | String | 订单 ID | | createTime | Long | 订单创建日期 | | updateTime | Long | 订单更新日期 | | listingTime | Long | 订单挂单时间 | | expirationTime | Long | 订单有效期，结束时间 | | status | String | 订单状态，包括 (active、cancelled、sold、inactive) | | orderHash | String | 订单 hash | | protocolData | String | 订单参数 (json) | | protocolAddress | String | 订单交易合约地址 | | chain | String | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | maker | String | 订单发起人的地址 | | orderType | String | 订单类型，Offer 代表出价单，BuyNow 代表挂单 | | price | String | 订单对应的每个 NFT 单价 | | currencyAddress | String | 订单对应的代币地址 | | collectionAddress | String | NFT 合约地址 | | tokenId | String | NFT Token ID | | amount | String | 订单对应的 NFT 数量 | | availableAmount | String | 订单当前可成交的 NFT 数量 | 订单参数模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E5%8F%82%E6%95%B0%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------------------------------------------- 订单请求参数详情 | 参数 | 类型 | 描述 | | --- | --- | --- | | offerer | String | 订单发起人的地址 | | offer | Array | 订单发起方提供的所有商品列表，一个[挂单项目模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%e6%8c%82%e5%8d%95%e9%a1%b9%e7%9b%ae%e6%a8%a1%e5%9e%8b)
数组 | | consideration | Array | 订单接收方所提供的所有商品列表，一个[订单项目模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%e8%ae%a2%e5%8d%95%e9%a1%b9%e7%9b%ae%e6%a8%a1%e5%9e%8b)
数组 | | startTime | timestamp | 订单有效期，起始时间 | | endTime | timestamp | 订单有效期，结束时间 | | orderType | Number | orderType 根据两个不同的首选项为订单指定四种类型之一：[OrderType](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%e8%ae%a2%e5%8d%95%e7%b1%bb%e5%9e%8b) | | zone | String | | | zoneHash | String | 固定值：0x0000000000000000000000000000000000000000000000000000000000000000 | | salt | String | 随机数 | | conduitKey | String | 固定值：0x066003C1493A346357Af15158cD985b4A6e29D3F888888888888888888888888 | | totalOriginalConsiderationItems | Number | 订单列表数量 | | counter | Number | 订单发起次数的计数器 | 挂单项目模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E6%8C%82%E5%8D%95%E9%A1%B9%E7%9B%AE%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------------------------------------------- 订单发起方提供的所有商品列表。如果是 listing 单，应该是一个 ERC721 或者 ERC1155 的 NFT 列表，如果是 offer 单，应该是一个只有代币信息的列表。 | 参数 | 类型 | 描述 | | --- | --- | --- | | itemType | number | item 类型：[itemType](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%e9%a1%b9%e7%9b%ae%e7%b1%bb%e5%9e%8b) | | token | String | item 资产对应的合约地址 | | identifierOrCriteria | String | item 如果是 NFT，那么代表的是 NFT 的 tokenId，如果是代币，可以忽略这个值 | | startAmount | number | 订单成交时，item 提供的数量 | | endAmount | number | 订单最终成交的 item 数量 | 订单项目模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E9%A1%B9%E7%9B%AE%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------------------------------------------- 订单接收方所提供的所有商品列表。这个列表包含三部分内容 (按照排序)： 1. 资产信息( offer 单时为 NFT，listing 单时为 offer 费用) 2. OKX 平台手续费 (可选) 3. 合集版税（可选） | 参数名 | 类型 | 描述 | | --- | --- | --- | | itemType | number | item 类型：[itemType](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%e9%a1%b9%e7%9b%ae%e7%b1%bb%e5%9e%8b) | | token | String | item 资产对应的合约地址 | | identifierOrCriteria | String | item 如果是 NFT，那么代表的是 NFT 的 tokenId，如果是代币，可以忽略这个值 | | startAmount | number | 订单成交时，item 提供的数量 | | endAmount | number | 订单最终成交的 item 数量 | | recipient | String | 每一个 item 对应的接收地址 | ### 枚举类[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E6%9E%9A%E4%B8%BE%E7%B1%BB) #### 订单类型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E7%B1%BB%E5%9E%8B) enum OrderType { FULL_OPEN, PARTIAL_OPEN, FULL_RESTRICTED, PARTIAL_RESTRICTED } #### 项目类型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E9%A1%B9%E7%9B%AE%E7%B1%BB%E5%9E%8B) enum ItemType { NATIVE, ERC20, ERC721, ERC1155, ERC721_WITH_CRITERIA, ERC1155_WITH_CRITERIA } 购买订单模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%B4%AD%E4%B9%B0%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------------------------------------------- 订单请求参数详情 | 参数名 | 类型 | 描述 | | --- | --- | --- | | orderId | String | 要购买的订单 ID | | takeCount | Array | 购买数量 | [合集相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) 目录 [订单状态枚举](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E7%8A%B6%E6%80%81%E6%9E%9A%E4%B8%BE) [欧易订单模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E6%AC%A7%E6%98%93%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) [订单参数模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E5%8F%82%E6%95%B0%E6%A8%A1%E5%9E%8B) [挂单项目模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E6%8C%82%E5%8D%95%E9%A1%B9%E7%9B%AE%E6%A8%A1%E5%9E%8B) [订单项目模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%AE%A2%E5%8D%95%E9%A1%B9%E7%9B%AE%E6%A8%A1%E5%9E%8B) [购买订单模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%B4%AD%E4%B9%B0%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) --- # 查询持有的 UTXO | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) 查询持有的 UTXO 查询持有的 UTXO[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos#%E6%9F%A5%E8%AF%A2%E6%8C%81%E6%9C%89%E7%9A%84-utxo) =================================================================================================================================== 查询 BTC 、Fractal Bitcoin 链指定地址下的 UTXO。 按照资产大小倒序排序，整体最多返回 10000 条。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/utxo/utxos` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | address | String | Yes | 地址信息，必填 | | cursor | String | No | 游标，默认第一的位置 | | limit | String | No | 默认 50，最大 100 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | utxos | Array | 地址下的 UTXO 列表 | | \>txHash | String | 交易 hash | | \>voutIndex | String | 标识 UTXO 位于输出的第几位，和 txhash 一起，可以唯一映射指定的 UTXO | | \>amount | String | 返回的 UTXO 的大小，单位是聪 | | \>spendStatus | String | UTXO 的花费状态
`1`: spending(花费中)
`2`: unspend（未花费） | | cursor | String | 游标 | [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/utxo/utxos?chainIndex=0&address=bc1p8qfrmxdlmynr076uu28vlszxavwujwe7dus0r8y9thrnp5lgfh6qu2ctrr' --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "cursor": "1",\ "utxos": [\ {\ "txHash": "9e334346dd977cd766895c930e3921265abddb19fda4df0aa5cfd7d9201ed30a",\ "voutIndex": "0",\ "amount": "0.001",\ "spendStatus": "2"\ },\ {\ "txHash": "d23531d511a841b67022aad0d21d82d66e1b35f023670398579540e84e23255c",\ "voutIndex": "1",\ "amount": "0.0008485",\ "spendStatus": "2"\ },\ {\ "txHash": "5af52eda570c7f368793cd10788ce92bd2cbbf0668210306b82e63dd721c236a",\ "voutIndex": "1",\ "amount": "0.00084643",\ "spendStatus": "2"\ },\ {\ "txHash": "54d4a7c116db0fb329e458afa2e9004244d43865fce40179f75a5adc9c006fdc",\ "voutIndex": "1",\ "amount": "0.00084083",\ "spendStatus": "2"\ },\ {\ "txHash": "1cb254487dac6b52dab68c9566b90b9423667f8789c1eeeb1936571cc702005e",\ "voutIndex": "2",\ "amount": "0.00040348",\ "spendStatus": "2"\ },\ {\ "txHash": "562428df1f5cdcaca9f6183dc0fe9d8a4f9e310a2c8fce4a5d3a6341e04f1455",\ "voutIndex": "1",\ "amount": "0.0001",\ "spendStatus": "2"\ },\ {\ "txHash": "7c0dbe192e5595f23cf7a65e4497edd5c98ccf20e3299c1fafa19db6485b29b9",\ "voutIndex": "0",\ "amount": "0.0001",\ "spendStatus": "2"\ },\ {\ "txHash": "0b70ed133dab27f44f115c81198a73853ef7d225c16f1fa8da3a618dcee45a8b",\ "voutIndex": "0",\ "amount": "0.00009065",\ "spendStatus": "2"\ },\ {\ "txHash": "c1ce0a65ea9d13915a3703be1dc56cdfb75cf187aaf5fbf94af2f577f2834f3b",\ "voutIndex": "1",\ "amount": "0.00007924",\ "spendStatus": "2"\ },\ {\ "txHash": "d3fe9ff28b85ca494ea5ac99414cfd92fbf4c18948ed5e805b2b908763c70559",\ "voutIndex": "0",\ "amount": "0.000018",\ "spendStatus": "2"\ },\ {\ "txHash": "c8b69de2e3e0f89a2c6d73570c5f86b49d2f2a7635d8e7c9e85e593ab20ec9f7",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "a1af403781f8a78be8fcd3b1c3f7d3834f9c5c96e96ab7de2c591abe95ad1b77",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "dcf6575f35040c3203181925e46cb65d8663c950f04c38ec836a1047bc4b6e1d",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "a4323a33b894710b023b15ec1cc04b31a305026401edcaa1efbd63e30ef1c29f",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "b44859f6496c394b65290f66aea756516cce13b71a243530da6b4c0cd05187a5",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "8409b14c213ca2980141ee7706b790109b83d0c16a2748f11936a23cac1c2cda",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "562428df1f5cdcaca9f6183dc0fe9d8a4f9e310a2c8fce4a5d3a6341e04f1455",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "c6408557c17429f29a77372a0911e3d6a7849a2b1e1dc2dda96b1085b8262013",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "a9cd8b4a9c751578cf81cdcf324f7c7461ed12624d6eeac67eab541732e4f34f",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "02c036196f148a9cdd9fc8abc7b8ef124feb84375a1d708126fab6d319bee7a1",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "bf9536057243e0021ecd7f4a40934bbec766cfeacee85569131165f8bd3d19e9",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "c98cee07c44d26b47e351df12757e88d052fea6ee7ab8588e2c1d68324d5388c",\ "voutIndex": "0",\ "amount": "0.000012",\ "spendStatus": "2"\ },\ {\ "txHash": "f230741451130da4e15bbbe37f4beda7bbaf9b5b4e881e79ac9f94a920c7730e",\ "voutIndex": "0",\ "amount": "0.00001",\ "spendStatus": "2"\ },\ {\ "txHash": "0ffc438bb4a5ef6a79108485fe4334a98f4dcbc8b9d914f211e67f3c720a1cfe",\ "voutIndex": "0",\ "amount": "0.00001",\ "spendStatus": "2"\ },\ {\ "txHash": "8f1387b1f67f0b04923a9980818645c45fe55724c8ab91ee00930fcf12407734",\ "voutIndex": "0",\ "amount": "0.00001",\ "spendStatus": "2"\ },\ {\ "txHash": "9caa4f86c9a368800ad0f94648bede27ed0229142eb89a49d54bcce97239a000",\ "voutIndex": "0",\ "amount": "0.00001",\ "spendStatus": "2"\ },\ {\ "txHash": "ed031c5c5eabe4f137d95b6a8ae714eff54e42887cf80f78ded88a36f3d75dad",\ "voutIndex": "0",\ "amount": "0.00001",\ "spendStatus": "2"\ },\ {\ "txHash": "d3fe9ff28b85ca494ea5ac99414cfd92fbf4c18948ed5e805b2b908763c70559",\ "voutIndex": "6",\ "amount": "0.000006",\ "spendStatus": "2"\ },\ {\ "txHash": "09add0ddb2444f2077c4ddfaafe8ba79855237467d2d3ceaf74d13ec0135a33f",\ "voutIndex": "1",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "ef2cf264fc5ac437446c9f82c396241a8d84d0af35333d14eb780758c7dfb8fa",\ "voutIndex": "1",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "5443eca0ec477505b26c2ff7d8479f218d093df552132d542547865a8d5489d1",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "7ad7d948cba112cbb0122979578714ad3157bf17ee397f55d6f9b542d5360388",\ "voutIndex": "1",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "52aaab23cfe17dccad63220647d9c0cb77a45bd1334d324bba487472c2d37501",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "6e5c6c1206e2ff076dcddda6fbacbd6faf42d49a512adab7b9732b1099680273",\ "voutIndex": "1",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "7345405bb0fb6b846e3c1bfac8b9ef5dfec727444fcf6ad41c74c8f5b6cb99db",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "4f1e0f6842bd595362d74558f31105977d64060b6c587b3be257c6e648f1d44c",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "703a5caa76b3bb97114c6eed4d533d99f44210ed000313b4b8d5878a9bc26a36",\ "voutIndex": "1",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "69f9ff6843ea684fe68751adb8fb2fe1ae8caf553999c389bf5fcacf018c4f48",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "4c59b50c43a00b6db36129a9bcd16e88b39948070dd110660fee2b1ff61545da",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "2361f87d211d6b2982647e9ca776c2368daad41609d1ae25a45f95bf5e26b896",\ "voutIndex": "2",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "9b83ac2f681ec69cddf330949a1dd0215d10e7ec45bbd9741680449218ac376d",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "6eca7731240f4e3b8d68a25183e17f1c7079fb0fca60ea2836eef65d7cfbe2cf",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "a8e5e909db42a0ddbcb58964d0dbdafb0c810303d275584d53614c47b06422fa",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "ee50b94275d8b57bd4bb9a5b6978f58615b7ab6ce925624e2cddd7adfd13e75e",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "6688f647df1a320a5b9c37a95b127777082085702eaec98cba53d428e4a80ad4",\ "voutIndex": "2",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "6dd734bb29e4c6b978351fe527632fa2546716f9d2e6f65a3e804f077147a15e",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "2e9d38d44c130d692a82a07d73e722463c494f0b4a552d21e0612be00e7a9809",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "f5e53dcfbf891fbe6c44865930921d30d060a8a65a585fdd6f1ca0c25baa93f9",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "a9cd8b4a9c751578cf81cdcf324f7c7461ed12624d6eeac67eab541732e4f34f",\ "voutIndex": "1",\ "amount": "0.00000546",\ "spendStatus": "2"\ },\ {\ "txHash": "7ccfaaab90e45b2a51729a0ab79d270dbf2616d42c118f55a9e9bb9f33ecfed3",\ "voutIndex": "0",\ "amount": "0.00000546",\ "spendStatus": "2"\ }\ ]\ }\ ] } [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) --- # 获取支持的链 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 获取支持的链 获取支持的链[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains#%E8%8E%B7%E5%8F%96%E6%94%AF%E6%8C%81%E7%9A%84%E9%93%BE) ====================================================================================================================================== 获取支持限价单兑换的链信息，通过请求返回支持限价单的链。 ### 支持的链[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains#%E6%94%AF%E6%8C%81%E7%9A%84%E9%93%BE) * Ethereum Mainnet * OP Mainnet * Polygon Mainnet * BNB Smart Chain Mainnet * OKT Chain * Avalanche C-Chain * Fantom Opera * Arbitrum One 提示 网络和 chainId 关联关系，请前往 [网络 chainId 映射](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks) 进行查看。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/dex/aggregator/limit-order/chain` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数 | 类型 | 必传 | 描述 | | --- | --- | --- | --- | | chainId | Integer | 否 | 链的唯一标识。
传空，则默认返回所有支持的链信息。
传指定的链 id，则返回对应链的信息。如`1`: Ethereum，更多可[查看资源部分](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks)
。 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数 | 类型 | 描述 | | --- | --- | --- | | chainId | Integer | 链的唯一标识。 （如`1`: Ethereum，更多可[查看资源部分](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks)
） | | chainName | String | 链名称 (如`Optimism`) | | dexTokenApproveAddress | String | dex 授权合约地址 | [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/dex/aggregator/limit-order/chain?chainId=1' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code":"0", "data":[\ {\ "chainId":137,\ "chainName":"Polygon",\ "dexTokenApproveAddress":"0x3B86917369B83a6892f553609F3c2F439C184e31"\ },\ {\ "chainId":43114,\ "chainName":"Avalanche C",\ "dexTokenApproveAddress":"0x40aA958dd87FC8305b97f2BA922CDdCa374bcD7f"\ },\ {\ "chainId":1,\ "chainName":"Ethereum",\ "dexTokenApproveAddress":"0x40aA958dd87FC8305b97f2BA922CDdCa374bcD7f"\ },\ {\ "chainId":66,\ "chainName":"OKTC",\ "dexTokenApproveAddress":"0x70cBb871E8f30Fc8Ce23609E9E0Ea87B6b222F58"\ },\ {\ "chainId":56,\ "chainName":"BNB Chain",\ "dexTokenApproveAddress":"0x2c34A2Fb1d0b4f55de51E1d0bDEfaDDce6b7cDD6"\ },\ {\ "chainId":250,\ "chainName":"Fantom",\ "dexTokenApproveAddress":"0x70cBb871E8f30Fc8Ce23609E9E0Ea87B6b222F58"\ },\ {\ "chainId":42161,\ "chainName":"Arbitrum",\ "dexTokenApproveAddress":"0x70cBb871E8f30Fc8Ce23609E9E0Ea87B6b222F58"\ },\ {\ "chainId":10,\ "chainName":"Optimism",\ "dexTokenApproveAddress":"0x68D6B739D2020067D1e2F713b999dA97E4d54812"\ }\ ], "msg":"" } [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) --- # 创建挂单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) 创建挂单 创建挂单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing#%E5%88%9B%E5%BB%BA%E6%8C%82%E5%8D%95) ======================================================================================================================== 该接口用于挂单到欧易和其他市场 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/markets/create-listing` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **字段名** | **类型** | **是否必传** | **说明** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | walletAddress | String | 是 | 挂单的钱包地址 | | collectionAddress | String | 是 | NFT 合约地址 | | tokenId | String | 是 | NFT 的 tokenId | | price | String | 是 | NFT 的价格，十进制的， 例子：2000000 是 2 | | currencyAddress | String | 是 | 挂单对应计价货币的合约地址，各条网络上的原生币如 eth，地址默认为 0x00000000000000000000
00000000000000000000 | | count | Integer | 是 | NFT 的数量，721 类型为 1 | | validTime | String | 是 | 挂单截止时间戳 (s)，例子：2039-09-19 07:06:40 转换为时间戳后是 2200000000 | | platform | String | 是 | 目标挂单平台，详情见[已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) | [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X POST "https://web3.okx.com/api/v5/mktplace/nft/markets/create-listing" \ -H "Content-Type: application/json" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d '{ "chain": "polygon", "walletAddress": "0x76e2da406db566f0e79764a2bf01b992997d0586", "items" : [\ {\ "collectionAddress": "0xa5561b779c086d37a77d7b35e97ce75bb9193491",\ "tokenId": "101837856840664764261208575168687881837850830083487668871567409609794568798800",\ "price": "50000000",\ "currencyAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",\ "count": 1,\ "validTime":1748057424,\ "platform": "okx"\ }\ ] }' ### 响应结果[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing#%E5%93%8D%E5%BA%94%E7%BB%93%E6%9E%9C) 200 { "code": 0, "data": { "errors": [], "orders": [\ {\ "collectionAddress": "0xa5561b779c086d37a77d7b35e97ce75bb9193491",\ "count": "1",\ "currencyAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",\ "id": "a07b10bb8da04a9183cd0ca216126071",\ "listingProfit": "",\ "nftId": "27278971523568785",\ "platform": "okx",\ "platformFeePoints": null,\ "price": "50000000",\ "project": "",\ "protocolFeePoints": null,\ "royaltyFeePoints": null,\ "source": 4,\ "tokenId": "101837856840664764261208575168687881837850830083487668871567409609794568798800",\ "validTime": 1748057424\ }\ ], "steps": [\ {\ "action": "ApprovalItems",\ "items": [\ {\ "approvalAddress": "0x1e0049783f008a0085193e00003d00cd54003c71",\ "chain": 137,\ "collectionAddress": "0xa5561b779c086d37a77d7b35e97ce75bb9193491",\ "description": "",\ "kind": "nftApproval",\ "orderIds": [\ "a07b10bb8da04a9183cd0ca216126071"\ ],\ "platform": {\ "icon": "https://static.coinall.ltd/cdn/nft/1f4d2f3f-774c-4386-b8e1-52533d1af81d.webp",\ "name": "OKX",\ "source": 4\ },\ "platforms": [\ {\ "icon": "https://static.coinall.ltd/cdn/nft/1f4d2f3f-774c-4386-b8e1-52533d1af81d.webp",\ "name": "OKX",\ "source": 4\ }\ ],\ "status": "complete"\ }\ ]\ },\ {\ "action": "SignOrders",\ "items": [\ {\ "data": {\ "conduitKey": "0x0000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000",\ "consideration": [\ {\ "endAmount": "49000000",\ "identifierOrCriteria": "0",\ "itemType": 1,\ "recipient": "0x76e2da406db566f0e79764a2bf01b992997d0586",\ "startAmount": "49000000",\ "token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"\ },\ {\ "endAmount": "1000000",\ "identifierOrCriteria": "0",\ "itemType": 1,\ "recipient": "0xecd8c2d00b969fddbb06c2c6bec9a98a7d8dfb85",\ "startAmount": "1000000",\ "token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"\ }\ ],\ "counter": "0",\ "endTime": "1748057424",\ "offer": [\ {\ "endAmount": "1",\ "identifierOrCriteria": "101837856840664764261208575168687881837850830083487668871567409609794568798800",\ "itemType": 2,\ "startAmount": "1",\ "token": "0xa5561b779c086d37a77d7b35e97ce75bb9193491"\ }\ ],\ "offerer": "0x76e2da406db566f0e79764a2bf01b992997d0586",\ "orderType": 2,\ "salt": "0x000000000000000000000000000000000000000000000000eb1c8424e64a1eec",\ "startTime": 1719209238,\ "totalOriginalConsiderationItems": 2,\ "zone": "0xdf2d4bffec010debd302674c9fb9cda99bb5e852",\ "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000"\ },\ "description": "",\ "domain": {\ "chainId": 137,\ "name": "Seaport",\ "verifyingContract": "0x0000000000000068f116a894984e2db1123eb395",\ "version": "1.6"\ },\ "kind": "signature",\ "orderIds": [\ "a07b10bb8da04a9183cd0ca216126071"\ ],\ "platform": {\ "icon": "https://static.coinall.ltd/cdn/nft/1f4d2f3f-774c-4386-b8e1-52533d1af81d.webp",\ "name": "OKX",\ "source": 4\ },\ "platforms": [\ {\ "icon": "https://static.coinall.ltd/cdn/nft/1f4d2f3f-774c-4386-b8e1-52533d1af81d.webp",\ "name": "OKX",\ "source": 4\ }\ ],\ "post": {\ "body": {\ "chain": 137,\ "items": [\ {\ "collectionAddress": "0xa5561b779c086d37a77d7b35e97ce75bb9193491",\ "count": "1",\ "currencyAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",\ "id": "a07b10bb8da04a9183cd0ca216126071",\ "listingProfit": "",\ "nftId": "27278971523568785",\ "platform": "okx",\ "platformFeePoints": null,\ "price": "50000000",\ "project": "",\ "protocolFeePoints": null,\ "royaltyFeePoints": null,\ "source": 4,\ "tokenId": "101837856840664764261208575168687881837850830083487668871567409609794568798800",\ "validTime": 1748057424\ }\ ],\ "orderData": "",\ "r": "",\ "s": "",\ "signature": "",\ "walletAddress": "0x76e2da406db566f0e79764a2bf01b992997d0586"\ },\ "endpoint": "/priapi/v1/nft/trading/seaport/step/submitOrder",\ "method": "post"\ },\ "primaryType": "OrderComponents",\ "signKind": "eip712",\ "status": "incomplete",\ "types": {\ "ConsiderationItem": [\ {\ "name": "itemType",\ "type": "uint8"\ },\ {\ "name": "token",\ "type": "address"\ },\ {\ "name": "identifierOrCriteria",\ "type": "uint256"\ },\ {\ "name": "startAmount",\ "type": "uint256"\ },\ {\ "name": "endAmount",\ "type": "uint256"\ },\ {\ "name": "recipient",\ "type": "address"\ }\ ],\ "OrderComponents": [\ {\ "name": "offerer",\ "type": "address"\ },\ {\ "name": "zone",\ "type": "address"\ },\ {\ "name": "offer",\ "type": "OfferItem[]"\ },\ {\ "name": "consideration",\ "type": "ConsiderationItem[]"\ },\ {\ "name": "orderType",\ "type": "uint8"\ },\ {\ "name": "startTime",\ "type": "uint256"\ },\ {\ "name": "endTime",\ "type": "uint256"\ },\ {\ "name": "zoneHash",\ "type": "bytes32"\ },\ {\ "name": "salt",\ "type": "uint256"\ },\ {\ "name": "conduitKey",\ "type": "bytes32"\ },\ {\ "name": "counter",\ "type": "uint256"\ }\ ],\ "EIP712Domain": [\ {\ "name": "name",\ "type": "string"\ },\ {\ "name": "version",\ "type": "string"\ },\ {\ "name": "chainId",\ "type": "uint256"\ },\ {\ "name": "verifyingContract",\ "type": "address"\ }\ ],\ "OfferItem": [\ {\ "name": "itemType",\ "type": "uint8"\ },\ {\ "name": "token",\ "type": "address"\ },\ {\ "name": "identifierOrCriteria",\ "type": "uint256"\ },\ {\ "name": "startAmount",\ "type": "uint256"\ },\ {\ "name": "endAmount",\ "type": "uint256"\ }\ ]\ }\ }\ ]\ }\ ] }, "msg": "" } [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) --- # 查询用户全网持仓列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) 查询用户全网持仓列表 查询用户全网持仓列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list#%E6%9F%A5%E8%AF%A2%E7%94%A8%E6%88%B7%E5%85%A8%E7%BD%91%E6%8C%81%E4%BB%93%E5%88%97%E8%A1%A8) ======================================================================================================================================================================================================= 描述：该 API 将提供用户全网的资产持仓列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/user/asset/platform/list`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | walletAddressList | 用户钱包地址列表 | 请求体 | 是 | Array | | \>chainId | 公链 ID | 请求体 | 是 | String | | \>walletAddress | 用户钱包地址 | 请求体 | 是 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | walletIdPlatformList | 地址集对应的仓位列表 | Array | | \>platformList | 一个地址的持仓列表 | String | | \>platformName | 平台名称 | String | | \>analysisPlatformId | 协议ID | String | | \>platformLogo | 平台图标 | String | | \>currencyAmount | 美元持仓金额 | String | | \>isSupportInvest | Okx DeFi是否支持 | String | | \>platformUrl | 平台链接 | String | | \>networkBalanceVoList | 不同网络下的持仓列表 | Array | | \>>network | 网络名称 | String | | \>>networkLogo | 网络图标 | String | | \>>chainId | 链ID | String | | \>>currencyAmount | 美元持仓金额 | String | | \>investmentCount | 在投投资品数量 | String | [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/user/asset/platform/list' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "walletAddressList": [\ {\ "chainId": 1,\ "walletAddress": "0x655b35f11006617696a4b31978ba4c078b6b7145"\ }\ ] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "error_code": "0", "error_message": "", "detailMsg": "", "data": { "walletIdPlatformList": [\ {\ "platformList": [\ {\ "platformName": "Ethena",\ "analysisPlatformId": 118265,\ "platformLogo": "https://static.coinall.ltd/cdn/web3/protocol/logo/1702889213278.png/type=png_350_0",\ "platformColor": "",\ "currencyAmount": "10076.999426431322729394061370751783986",\ "isSupportInvest": true,\ "bonusTag": 0,\ "platformUrl": "https://app.ethena.fi",\ "networkBalanceVoList": [\ {\ "network": "ETH",\ "networkLogo": "https://static.coinall.ltd/cdn/wallet/logo/ETH-20220328.png",\ "chainId": 1,\ "currencyAmount": "10076.999426431322729394061370751783986"\ }\ ],\ "investmentCount": 1\ },\ {\ "platformName": "Pendle V2",\ "analysisPlatformId": 258,\ "platformLogo": "https://static.coinall.ltd/cdn/web3/protocol/logo/pendle-v2.png/type=png_350_0",\ "platformColor": "",\ "currencyAmount": "161.9345234089089141378517476223121560",\ "isSupportInvest": true,\ "bonusTag": 0,\ "platformUrl": "https://www.pendle.finance/",\ "networkBalanceVoList": [\ {\ "network": "ETH",\ "networkLogo": "https://static.coinall.ltd/cdn/wallet/logo/ETH-20220328.png",\ "chainId": 1,\ "currencyAmount": "161.9345234089089141378517476223121560"\ }\ ],\ "investmentCount": 2\ },\ {\ "platformName": "Zircuit",\ "analysisPlatformId": 119424,\ "platformLogo": "https://static.coinall.ltd/cdn/web3/protocol/logo/zircuit.png/type=png_350_0",\ "platformColor": "",\ "currencyAmount": "156.9108954533033331829362703655488",\ "isSupportInvest": true,\ "bonusTag": 0,\ "platformUrl": "https://stake.zircuit.com/",\ "networkBalanceVoList": [\ {\ "network": "ETH",\ "networkLogo": "https://static.coinall.ltd/cdn/wallet/logo/ETH-20220328.png",\ "chainId": 1,\ "currencyAmount": "156.9108954533033331829362703655488"\ }\ ],\ "investmentCount": 1\ }\ ],\ "walletId": "8f4d93d7-275e-45dd-a0ce-2014d82d4baf",\ "totalAssets": "10395.8448452935349767148493887396449420"\ }\ ], "lpTokenAddressList": [\ {\ "chainId": 1,\ "tokenAddress": "0xdc02b77a3986da62c7a78fed73949c9767850809"\ }\ ], "updateAt": 1727083602000, "assetStatus": 1 } } [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) --- # 提交挂单 | 创建 Ordinals 挂单 | Ordinals API | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/ordinals-quick-start) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions) [提交挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) [获取 Ordinals 订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-listings) [获取 Ordinals 交易历史](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-activities) [Ordinals 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinal-model) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [Ordinals API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [创建 Ordinals 挂单](https://web3.okx.com/zh-hans/build/docs/waas/create-ordinals-api) 提交挂单 提交挂单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing#%E6%8F%90%E4%BA%A4%E6%8C%82%E5%8D%95) =============================================================================================================================== 该接口用于将铭文挂单到 OKX 平台。 包括 BTC NFT 和 BRC-20。 返回数据 success = true 则代表成功挂单。获取 psbt 前需要获取铭文的 UTXO，要获取 UTXO 请用这个接口[查询 UTXO](https://web3.okx.com/cn/web3/build/docs/waas/api-transaction-get-utxo) 。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/ordinals/okx/make-orders` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | nftId | String | 是 | 挂单 NFT 的 ID | | inscriptionId | String | 是 | 铭文的 ID | | orderType | Integer | 是 | 订单类型。 挂单是 2 | | unitPrice | BigDecimal | 是 | BRC-20 的单价 / 一个 NFT 的价格，单位：聪 | | isBrc20 | Boolean | 否 | 获取全部 BTC NFT 或 BRC-20 合集的列表，默认为 BRC-20 | | psbt | String | 是 | 交易所需的签名。 只接受 base64 编码的 psbt | | totalPrice | BigDecimal | 是 | 从 NFT 角度看，这是一个 NFT 的价格；从 BRC-20 角度看，这里为 BRC-20 的总价。 单位：聪 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | **参数** | **类型** | **描述** | | --- | --- | --- | | nftId | String | 挂单 NFT 的 ID | | success | Boolean | 成功将返回true，失败则返回 false。 | | errorMsg | String | 请求失败的详细错误消息 | [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) ### 代码请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing#%E4%BB%A3%E7%A0%81%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/mktplace/nft/ordinals/okx/make-orders' \ --header 'OK-ACCESS-KEY: your api key' \ --header 'OK-ACCESS-PASSPHRASE: your passphrase' \ --header 'Content-Type: application/json' \ --data '{ "brc20": false, "items": [\ {\ "inscriptionId": "02ecbe7ef5143...3f3de87a7c6e64409883f66f4e3036i0",\ "nftId": 20824...473273458, // get this data part 1 step 2 by mapping it to inscriptionId\ "orderType": 2,\ "totalPrice": 100000, // this price should match part 3 step 1\ "unitPrice": 100000, // this price will varies for BRC20 or btc NFT. Check out NOTE on unitPrice\ "psbt": "cHNidP8BAP0GAQIAAAADAAAAAAAA...ZUDTZKgR6mGJSkBSJuPsgb2gGCekW+W04EtAAAAAA=",\ }\ ] } ' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-create-listing#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "result": [\ {\ "nftID": 20824...473273458,\ "errorMsg": "",\ "success": true,\ }\ ] } [获取铭文资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-get-inscriptions) [获取 Ordinals 合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-ordinal-collection-list) --- # 查询协议列表 | 查询信息 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询协议列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) [查询产品列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-list) [查询产品详情](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) [查询网络列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-network-list) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) 查询协议列表 查询协议列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list#%E6%9F%A5%E8%AF%A2%E5%8D%8F%E8%AE%AE%E5%88%97%E8%A1%A8) ======================================================================================================================================================== 描述：该 API 将提供协议和投资产品的简要信息，用以进一步获取投资品详情。如果参数不存在，则会列出所有协议信息。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET **`https://web3.okx.com/api/v5/defi/explore/protocol/list`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | platformId | 平台 ID | 请求参数 | 否 | String | | platformName | 平台官方名称 | 请求参数 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | platformId | 平台 ID | String | | platformName | 平台官方名称 | String | | platformWebSite | 平台官网 | String | | investmentApiUrlPattern | 投资品详情，非 UI 的 URL 地址 | String | | investmentPageUrlPattern | 投资品详情，欧易官网 UI 的 URL 地址 | String | | platformMinInfos | 平台信息 | Array\[Struct\] | | \>investmentId | 投资品 ID | String | | \>protocolId | 协议 ID | String | | \>network | 投资品网络 | String | | \>chainId | 投资品链 ID | String | [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/explore/protocol/list' \ --header 'OK-ACCESS-KEY: 4b****53' \ --header 'OK-ACCESS-PASSPHRASE: p****d' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": [\ {\ "platformId": 149,\ "platformName": "MorphoCompound",\ "platformWebSite": "https://compound.morpho.xyz/?network=mainnet",\ "investmentApiUrlPattern": "",\ "investmentPageUrlPattern": "",\ "platformMinInfos": [\ {\ "investmentId": "20926",\ "protocolId": "194",\ "network": "OP"\ },\ {\ "investmentId": "20949",\ "protocolId": "195",\ "network": "OP"\ }\ ]\ },\ {\ "platformId": 144,\ "platformName": "Compound V3",\ "platformWebSite": "https://app.compound.finance",\ "investmentUrlPattern": "",\ "platformMinInfos": [\ {\ "investmentId": "8973",\ "protocolId": "75",\ "network": "OP"\ }\ ]\ }\ ] } [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [查询代币列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-token-list) --- # 查询授权 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) 查询授权 查询授权[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail#%E6%9F%A5%E8%AF%A2%E6%8E%88%E6%9D%83) ============================================================================================================================= 分页查询单个地址，授权了哪些项目。以及每个授权项目下，授权的资产和额度。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) POST `https://web3.okx.com/api/v5/wallet/security/approvals` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | addressList | Array | Yes | 地址列表，最多20个 | | \>chainIndex | String | Yes | 链唯一标识 | | \>address | String | Yes | 地址信息 | | limit | String | No | 每次查询多少条,默认值为 50，最大100 | | cursor | String | No | 游标位置，默认为第一个 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | chainIndex | String | 链唯一标识 | | cursor | String | 游标 | | approvalProjects | Array | 授权项目列表 | | \>projectName | String | 项目名称 | | \>projectIcon | String | 项目icon | | \>approveAddress | String | 授权项目地址 | | \>tokens | Array | 授权币种列表 | | \>>imageUrl | String | 币种logo 地址 | | \>>symbol | Array | 币种简称 | | \>>status | String | 授权状态:
`1`: 成功
`2`: 取消中
`3`:授权中 | | \>>tokenAddress | String | 代币合约地址 | | \>>approvalNum | String | 授权整数，具体授权数量 = 授权整数 / 10 ^ 精度 | [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request POST 'https://web3.okx.com/api/v5/wallet/security/approvals' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ --data-raw '{ addressList:[\ {\ "chainIndex":"0",\ "address":"3HyNd5YsqxyuieicbpKGfV2nBXgMn41dSd",\ }\ ], "limit": "10", "cursor": "1" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "", "data": [\ {\ "cursor":"100",\ "chainIndex": "1",\ "approvalProjects": [\ {\ "projectIcon": "https://static.oklink.com/cdn/explorer/defi/uniswapv2.png",\ "projectName": "Uniswap",\ "approvalAddress": "0x2c34a2fb1d0b4f55de51e1d0bdefaddce6b7cdd6",\ "tokens": [\ {\ "approvalNum": "2744484",\ "imageUrl": "https://static.coinall.ltd/cdn/wallet/logo/tusd.png",\ "symbol": "TUSD",\ "status": "1",\ "tokenAddress": ""\ }\ ]\ }\ ]\ }\ ] } [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) --- # 获取 NFT 列表 | NFT API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [获取 NFT 详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details) [获取 NFT 列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) 获取 NFT 列表 获取 NFT 列表[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list#%E8%8E%B7%E5%8F%96-nft-%E5%88%97%E8%A1%A8) =================================================================================================================================== 该接口用来获取欧易平台上特定链和合约地址下的 NFT 列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/asset/list` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | contractAddress | String | 是 | 合约地址，必须是一个有效的合约地址 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 300，最大 300） | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个 [NFT 模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model.html#NFT%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | name | String | NFT 的名称 | | tokenId | String | NFT 的 token ID | | tokenUri | String | NFT 的元数据地址 | | image | String | NFT 的图片地址 | | imagePreviewUrl | String | NFT 的图片预览图地址 | | imageThumbnailUrl | String | NFT 的图片缩略图地址 | | animationUrl | String | NFT 的音视频资源地址 | | attributes | Object | NFT 的特殊属性信息，一个[属性模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#%E5%B1%9E%E6%80%A7%E6%A8%A1%E5%9E%8B) | | assetContracts | Object | 合约信息，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
对象 | | collection | Object | 合集信息，一个[合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B)
对象 | [获取 NFT 详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/asset/list" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "chain=xxx" \ -d "contractAddress=xxx" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": [{\ "animationUrl": "",\ "assetContract": {\ "chain": "Ethereum",\ "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "erc2981": false,\ "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",\ "tokenStandard": "erc721"\ },\ "attributes": "[{\"trait_type\":\"Background\",\"value\":\"Gray\"},{\"trait_type\":\"Fur\",\"value\":\"Dark Brown\"},{\"trait_type\":\"Hat\",\"value\":\"Laurel Wreath\"},{\"trait_type\":\"Mouth\",\"value\":\"Bored Unshaven Cigarette\"},{\"trait_type\":\"Clothes\",\"value\":\"Smoking Jacket\"},{\"trait_type\":\"Eyes\",\"value\":\"Bloodshot\"}]",\ "collection": {\ "assetContracts": [\ {\ "chain": "Ethereum",\ "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "erc2981": false,\ "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",\ "tokenStandard": "erc721"\ }\ ],\ "backgroundImage": "https://static.coinall.ltd/cdn/nft/files/collection/205-background.png",\ "categoryList": [\ "Collectibles"\ ],\ "certificateFlag": true,\ "des": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",\ "discordUrl": "https://discord.gg/3P5K3dzgdB",\ "image": "https://static.coinall.ltd/cdn/nft/d962ef0d-1cc1-4333-b19f-fc19c7322335.jpg",\ "instagramUrl": "",\ "mediumUrl": "",\ "name": "Bored Ape Yacht Club",\ "officialWebsite": "http://www.boredapeyachtclub.com/",\ "slug": "bored-ape-yacht-club",\ "stats": {\ "floorPrice": "105752.05",\ "latestPrice": "102662.45",\ "ownerCount": "5666",\ "totalCount": "10000",\ "totalVolume": "2239291136.375853"\ },\ "twitterUrl": "https://twitter.com/BoredApeYC"\ },\ "image": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp",\ "imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp/type=list",\ "imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp/type=detail",\ "name": "Bored Ape Yacht Club #11",\ "tokenId": "11",\ "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/11"\ }], "msg": "" } [获取 NFT 详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) --- # 查询用户协议维度持仓列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) 查询用户协议维度持仓列表 查询用户协议维度持仓列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail#%E6%9F%A5%E8%AF%A2%E7%94%A8%E6%88%B7%E5%8D%8F%E8%AE%AE%E7%BB%B4%E5%BA%A6%E6%8C%81%E4%BB%93%E5%88%97%E8%A1%A8) ============================================================================================================================================================================================================================= 描述：该 API 将提供用户协议维度的资产持仓列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/user/asset/platform/detail`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | analysisPlatformId | 协议ID | 请求体 | 是 | String | | walletAddressList | 地址列表 | 请求体 | 是 | Array | | \>chainId | 公链 ID | 请求体 | 是 | String | | \>walletAddress | 用户钱包地址 | 请求体 | 是 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | networkHoldVoList | 该网络下用户的持仓 | Array | | \>network | 网络名称 | String | | \>chainId | 链ID | String | | \>investTokenBalanceVoList | 在投仓位列表 | Array | | \>>investType | 投资品类型 (1、存币；2、流动性池；3、挖矿；4、机枪池；5、质押) | String | | \>>>tokenSymbol | 资产名称 | String | | \>>>tokenLogo | 资产图标 | String | | \>>>coinAmount | 在投资产数量 | String | | \>>>currencyAmount | 在投美元金额 | String | | \>>>tokenPrecision | 代币精度 | String | | \>>>tokenAddress | 代币地址 | String | | \>>>network | 网络 | String | | \>>totalValue | 仓位总美元价值 | String | | \>platformName | 协议名称 | String | | \>analysisPlatformId | 协议ID | String | | \>platformLogo | 协议图标 | String | | \>platformUrl | 协议链接 | String | [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/user/asset/platform/detail' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "analysisPlatformId": 260, "accountIdInfoList": [\ {\ "walletAddressList": [\ {\ "chainId": 42161, \ "walletAddress": "0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da"\ }\ ]\ }\ ] }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "error_code": "0", "error_message": "", "detailMsg": "", "data": { "walletIdPlatformDetailList": [\ {\ "networkHoldVoList": [\ {\ "network": "Arbitrum One",\ "chainId": 42161,\ "investTokenBalanceVoList": [\ {\ "investType": 5,\ "assetsTokenList": [\ {\ "tokenSymbol": "ETH",\ "tokenLogo": "https://static.coinall.ltd/cdn/wallet/logo/ETH-20220328.png",\ "coinAmount": "0.000044133940644863",\ "currencyAmount": "0.11722724912266575471",\ "tokenPrecision": 18,\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "ARB"\ }\ ],\ "rewardDefiTokenInfo": [],\ "totalValue": "0.11722724912266575471"\ }\ ],\ "availableRewards": [],\ "airDropRewardInfo": []\ }\ ],\ "accountId": "278c58bb-5958-4301-a5b6-d670e1d9837f"\ }\ ], "platformName": "ether.fi", "analysisPlatformId": 260, "platformLogo": "https://static.coinall.ltd/cdn/invest/platform/EtherFi.png", "platformUrl": "https://www.ether.fi/" } } [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) --- # 生成赎回交易的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) 生成赎回交易的调用数据 生成赎回交易的调用数据[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E7%94%9F%E6%88%90%E8%B5%8E%E5%9B%9E%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) ======================================================================================================================================================================================================================== 描述：该 API 将提供赎回交易的调用数据。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/transaction/redemption`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | address | 用户钱包地址 | 请求体 | 是 | String | | investmentId | 投资品 ID | 请求体 | 是 | String | | userInputList | 用户输入代币信息 | 请求体 | 是 | Array\[Struct\] | | \>chainId | 区块链 ID (默认：投资品网络) | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 是 | String | | \>tokenAddress | 认购代币的智能合约地址 (默认：投资品代币地址) | 请求体 | 否 | String | | expectOutputLIst | 用户预期收益信息 | 请求体 | 是 | Array\[Struct\] | | \>chainId | 区块链 ID | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 是 | String | | \>tokenAddress | 认购代币的智能合约地址 | 请求体 | 否 | String | | extra | 具体含义见备注 | 请求体 | 否 | String | ### 备注：[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E5%A4%87%E6%B3%A8%EF%BC%9A) extra 用法 redeemCalldataExtInfo * SUI Staking: [SUI staking investment](https://web3.okx.com/cn/web3/defi/detail/20801#source=search&orderToolType=redeem) * SOL Staking: [SOL staking investment](https://web3.okx.com/cn/web3/defi/detail/21530#source=search&orderToolType=redeem) [这个](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) 接口可以得到 investOrderList 字段，代表用户每一笔申购。 investOrderList.redeemExtra 代表 Call data Extra 需要的数据。 {"extra": "{\"redeemCalldataExtInfo\":[{\"unstakeIndex\":\"0xbc5118e65240dd5702218b37fd8d965d6eb4400474f34b6fe4a8f7805fc09405\"}]}"} ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | dataList | Call data 数据信息 | Array\[Struct\] | | \>from | 发送地址 (用户地址) | String | | \>to | 接受地址 (目标合约地址) | String | | \>value | 转账金额 (原生代币数量，默认为空字符串) | String | | \>serializedData | Call data 数据 | String | | \>originalData | 原始数据 (JSON) | JSON String | | \>callDataType | 操作类型 (授权、申购、赎回、领取) | String | | \>signatureData | 签名 Call data 数据信息，可用于验证数据由欧易生成 | String | ### 备注：[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E5%A4%87%E6%B3%A8%EF%BC%9A) 验签方法： 1. 使用 signatureData 签名信息计算出 r、s、v。 2. 与 to + serializedData + originalData 拼接成的字符串计算出验签 hash。 3. 恢复公钥验证。可由接入客户选则是否验签，如果验签成功，则说明该数据由欧易签名生成。 [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) 赎回示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E8%B5%8E%E5%9B%9E%E7%A4%BA%E4%BE%8B) -------------------------------------------------------------------------------------------------------------------------------------------------- ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/transaction/redemption' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "address": "0x7f****da", "investmentId": "21033", "userInputList": [\ {\ "chainId": 1,\ "coinAmount": "1",\ "tokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f"\ }\ ], "extra": "{\"redeemAll\":1}" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "dataList": [\ {\ "callDataType": "WITHDRAW",\ "from": "0x7f****da",\ "to": "0x83****ea",\ "value": "0x0",\ "serializedData": "0xba0876520000000000000000000000000000000000000000000000000cbb507c8eb3879f0000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da0000000000000000000000007f429edeff8afc7bb3a2cf7db832fc86f6fa99da",\ "originalData": "{\"callDataType\":\"WITHDRAW\",\"methodDefine\":\"redeem(uint256,address,address)\",\"methodId\":\"0xba087652\",\"methodType\":\"METHOD_ID\",\"params\":{\"params\":[\"917415445000325023\",\"0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da\",\"0x7f429edeff8afc7bb3a2cf7db832fc86f6fa99da\"]},\"useAdapter\":false}",\ "signatureData": "e6beeb6f9df6ecb7eb7791e57226f9eca1d7c3efa869172bb5021b9c827ad21b46e3dc4566608af727555e0a47aa90cf261331f4e1691b0201aa0b8a00ea685b1b"\ }\ ] } } [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) --- # 生成交易前授权的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) 生成交易前授权的调用数据 生成交易前授权的调用数据[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization#%E7%94%9F%E6%88%90%E4%BA%A4%E6%98%93%E5%89%8D%E6%8E%88%E6%9D%83%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) ===================================================================================================================================================================================================================================== 描述：该 API 将提供你进行交易前各种授权的调用数据。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/transaction/authorization`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | address | 用户钱包地址 | 请求体 | 是 | String | | investmentId | 投资品 ID | 请求体 | 是 | String | | type | 交易类型 (例如，3：认购授权；4：赎回授权；5：领取授权) | 请求体 | 是 | int | | userInputList | 用户输入代币信息 | 请求体 | 是 | Array\[Struct\] | | \>chainId | 区块链 ID | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 是 | String | | \>tokenAddress | 认购代币的智能合约地址 | 请求体 | 否 | String | | expectOutputLIst | 用户预期收益信息 | 请求体 | 否 | Array\[Struct\] | | \>chainId | 区块链 ID | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 否 | String | | \>tokenAddress | 认购代币的智能合约地址 | 请求体 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | dataList | Call date 数据信息 | Array\[Struct\] | | \>from | 发送地址 (用户地址) | String | | \>to | 接受地址 (目标合约地址) | String | | \>value | 转账金额 (原生代币数量，默认为空字符串) | String | | \>serializedData | Call data 数据 | String | | \>originalData | 原始数据 (JSON) | JSON String | | \>callDataType | 操作类型 (授权、申购、赎回、领取) | String | [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/transaction/authorization' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "address": "0x7f****da", "userInputList": [\ {\ "chainId": 56,\ "coinAmount": "10",\ "tokenAddress": "0x526a913a7a4518aa2abc3dcd3c46a9c73f40f94a"\ }\ ], "investmentId": "6925", "type": 3 }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "dataList": [\ {\ "from": "0x7f****da",\ "to": "0x52****4a",\ "value": "0x0",\ "serializedData": "0x095ea7b30000000000000000000000002c34a2fb1d0b4f55de51e1d0bdefaddce6b7cdd60000000000000000000000000000000000000000000000008ac7230489e80000",\ "originalDataClass": "OriginalDataApprove",\ "originalData": "{\"methodDefine\":\"approve(address,uint256)\",\"methodId\":\"0x095ea7b3\",\"methodType\":\"METHOD_ID\",\"params\":{\"params\":[\"0x2c34a2fb1d0b4f55de51e1d0bdefaddce6b7cdd6\",\"10000000000000000000\"]},\"useAdapter\":false}",\ "signatureData": "1bca0efbd1c809de94cdd8c924329c7ac79a4d346742de61925e8494f2c84c446bd3cf42b56d690c85ff513beadf46cd18f4e3e74845a92c48451584615f749d1c"\ }\ ] } } [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) --- # 获取合集详情 | 合集 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [获取合集详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details) [获取合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) 获取合集详情 获取合集详情[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details#%E8%8E%B7%E5%8F%96%E5%90%88%E9%9B%86%E8%AF%A6%E6%83%85) ======================================================================================================================================================= 该接口用于获取单个合集的详细信息，包括基础信息、合约信息和统计信息，例如地板价。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/collection/detail` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | slug | String | 是 | 合集 slug 名称，即合集的唯一标识 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | **参数** | **类型** | **描述** | | --- | --- | --- | | name | String | 合集名称 | | des | String | 合集简介 | | image | String | 合集头像图片地址 | | backgroundImage | String | 合集背景图片地址 | | slug | String | 合集 slug 名称，即合集的唯一标识 | | certificateFlag | Boolean | 合集认证标记 | | officialWebsite | String | 合集官网地址 | | instagramUrl | String | 合集 Instagram 地址 | | discordUrl | String | 合集 Discord 地址 | | mediumUrl | String | 合集 Medium 地址 | | twitterUrl | String | 合集推特地址 | | categoryList | Array | 合集分类标签列表 | | assetContracts | Array | 与该合集相关的合约信息列表，包括合约地址，协议标准，拥有者地址，是否支持 erc2981 协议等，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
数组 | | stats | Object | 该合集对应统计数据，包括交易额、地板价等，一个[合集统计信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E7%BB%9F%E8%AE%A1%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
对象 | [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [获取合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/collection/detail" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "slug=xxx" \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "NA==", "data": [\ {\ "assetContracts": [\ {\ "chain": "Ethereum",\ "contractAddress": "0xff9c1b15b16263c61d017ee9f65c50e4ae0113d7",\ "erc2981": false,\ "ownerAddress": "0xf296178d553c8ec21a2fbd2c5dda8ca9ac905a00",\ "tokenStandard": "erc721"\ }\ ],\ "backgroundImage": "https://static.coinall.ltd/cdn/nft/files/collection/8000-background.png",\ "categoryList": [],\ "certificateFlag": true,\ "des": "Loot is randomized adventurer gear generated and stored on chain. Stats, images, and other functionality are intentionally omitted for others to interpret. Feel free to use Loot in any way you want.",\ "discordUrl": "",\ "image": "https://static.coinall.ltd/cdn/nft/78d10ba9-63fc-4104-a13c-73e51ac2acb6.jpg",\ "instagramUrl": "",\ "mediumUrl": "",\ "name": "Loot (for Adventurers)",\ "officialWebsite": "https://lootproject.com",\ "slug": "loot-for-adventurers",\ "stats": {\ "floorPrice": "866.74799",\ "latestPrice": "616.4433",\ "ownerCount": "2522",\ "totalCount": "7779",\ "totalVolume": "552505219.5371664"\ },\ "twitterUrl": ""\ }\ ] }, "msg": "" } [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [获取合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list) --- # 获取合集列表 | 合集 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [获取合集详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details) [获取合集列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) 获取合集列表 获取合集列表[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list#%E8%8E%B7%E5%8F%96%E5%90%88%E9%9B%86%E5%88%97%E8%A1%A8) ==================================================================================================================================================== 该接口用来获取欧易平台上的合集列表。 要获取指定链的合集列表，请设置请求参数中的链名称 `chain` 字段。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/collection/list` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 否 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 300，最大 300）。返回最大的合集数 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个[合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model.html#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **说明** | | --- | --- | --- | | name | String | 合集名称 | | des | String | 合集简介 | | image | String | 合集头像图片地址 | | backgroundImage | String | 合集背景图片地址 | | slug | String | 合集 slug 名称，即合集的唯一标识 | | certificateFlag | Boolean | 合集认证标记 | | officialWebsite | String | 合集官网地址 | | instagramUrl | String | 合集 Instagram 地址 | | discordUrl | String | 合集 Discord 地址 | | mediumUrl | String | 合集 Medium 地址 | | twitterUrl | String | 合集推特地址 | | categoryList | Array | 合集分类标签列表 | | assetContracts | Array | 与该合集相关的合约信息列表，包括合约地址，协议标准，拥有者地址，是否支持 erc2981 协议等，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
数组 | | stats | Object | 该合集对应统计数据，包括交易额、地板价等，一个[合集统计信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E7%BB%9F%E8%AE%A1%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
对象 | [获取合集详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/collection/detail" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "chain=eth" \ -d "limit=1" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": [\ {\ "animationUrl": "",\ "assetContract": {\ "chain": "Ethereum",\ "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "erc2981": false,\ "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",\ "tokenStandard": "erc721"\ },\ "attributes": "[{\"trait_type\":\"Background\",\"value\":\"Gray\"},{\"trait_type\":\"Fur\",\"value\":\"Dark Brown\"},{\"trait_type\":\"Hat\",\"value\":\"Laurel Wreath\"},{\"trait_type\":\"Mouth\",\"value\":\"Bored Unshaven Cigarette\"},{\"trait_type\":\"Clothes\",\"value\":\"Smoking Jacket\"},{\"trait_type\":\"Eyes\",\"value\":\"Bloodshot\"}]",\ "collection": {\ "assetContracts": [\ {\ "chain": "Ethereum",\ "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "erc2981": false,\ "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",\ "tokenStandard": "erc721"\ }\ ],\ "backgroundImage": "https://static.coinall.ltd/cdn/nft/files/collection/205-background.png",\ "categoryList": [\ "Collectibles"\ ],\ "certificateFlag": true,\ "des": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",\ "discordUrl": "https://discord.gg/3P5K3dzgdB",\ "image": "https://static.coinall.ltd/cdn/nft/d962ef0d-1cc1-4333-b19f-fc19c7322335.jpg",\ "instagramUrl": "",\ "mediumUrl": "",\ "name": "Bored Ape Yacht Club",\ "officialWebsite": "http://www.boredapeyachtclub.com/",\ "slug": "bored-ape-yacht-club",\ "stats": {\ "floorPrice": "105752.05",\ "latestPrice": "102662.45",\ "ownerCount": "5666",\ "totalCount": "10000",\ "totalVolume": "2239291136.375853"\ },\ "twitterUrl": "https://twitter.com/BoredApeYC"\ },\ "image": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp",\ "imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp/type=list",\ "imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/8e8fd651-40cd-46e0-8e81-9d670f61e25b.webp/type=detail",\ "name": "Bored Ape Yacht Club #11",\ "tokenId": "11",\ "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/11"\ }\ ], "msg": "" } [获取合集详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-collection-details) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) --- # 资产相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [NFT 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) [资产相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) [合集相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) [订单相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) 资产相关模型 资产相关模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model#%E8%B5%84%E4%BA%A7%E7%9B%B8%E5%85%B3%E6%A8%A1%E5%9E%8B) ======================================================================================================================================= 欧易 API 中的一个主要对象是 NFT，它代表一个独特的数字项目，其所有权由区块链管理。 NFT 资产相关信息[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model#nft-%E8%B5%84%E4%BA%A7%E7%9B%B8%E5%85%B3%E4%BF%A1%E6%81%AF) ----------------------------------------------------------------------------------------------------------------------------------------------- | **参数** | **类型** | **描述** | | --- | --- | --- | | name | String | NFT 的名称 | | tokenId | String | NFT 的 token ID | | amount | String | 指定 tokenId 下 NFT 的总供应量 | | tokenUri | String | NFT 的元数据地址 | | image | String | NFT 的图片地址 | | imagePreviewUrl | String | NFT 的图片预览图地址 | | imageThumbnailUrl | String | NFT 的图片缩略图地址 | | animationUrl | String | NFT 的音视频资源地址 | | attributes | Object | NFT 的特殊属性信息，一个属性模型 | | assetContracts | Object | 合约信息，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
对象 | | collection | Object | 合集信息，一个[合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B)
对象 | | ownerAddress | String | 资产所有者的地址 | | isLazyMintType | Boolean | 是否为延迟铸币并且未发生转移 | [NFT 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) [合集相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) 目录 [NFT 资产相关信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model#nft-%E8%B5%84%E4%BA%A7%E7%9B%B8%E5%85%B3%E4%BF%A1%E6%81%AF) --- # 查询认购的预估计算信息 | 计算 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [查询认购的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment) [查询赎回的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) 查询认购的预估计算信息 查询认购的预估计算信息[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment#%E6%9F%A5%E8%AF%A2%E8%AE%A4%E8%B4%AD%E7%9A%84%E9%A2%84%E4%BC%B0%E8%AE%A1%E7%AE%97%E4%BF%A1%E6%81%AF) ========================================================================================================================================================================================================================== 描述: 该 API 将给你指定投资品的预估认购收益详情。内容包括： * 超级节点名、预估网络费相关； * 接收代币列表、凭证代币详情列表、收益代币详情列表、代币授权状态列表（包括是否需要授权）； * 可申购金额、最小申购数额、最大申购数额、币种交换汇率等。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/calculator/subscribe-info`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | address | 用户钱包地址 | 请求体 | 否 | String | | inputAmount | 认购代币数量 | 请求体 | 是 | String | | investmentCategory | 认购类型：(0：默认类型；1：BRC-20) | 请求体 | 否 | String | | investmentId | 投资品 ID ([这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list)
获取) | 请求体 | 是 | String | | inputTokenAddress | 认购代币的智能合约地址 ([这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details)
获取) | 请求体 | 是 | String | | isSingle | 判断是否为单币投资品：是：单币；否：多币 | 请求体 | 否 | Boolean | | slippage | 滑点：默认为 1% | 请求体 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | validatorName | 超级节点名称 | String | | isAllowSubscribe | 是否允许申购 | Boolean | | estimateGasFee | 收益率计算类型：0：APY；1：APR | String | | isSwapInvest | 是否是兑换投资 | Boolean | | exchangeRate | 币种汇率 | String | | investWithTokenList | 质押代币 | Array\[Struct\] | | \>coinAmount | 币种数量 | String | | \>currencyAmount | 币种美元价值 | String | | \>tokenSymbol | 币种标识 | String | | \>tokenName | 币种名称 | String | | \>tokenAddress | 币种的智能合约地址 | String | | \>tokenPrecision | 币种精确小数位 | String | | \>isBaseToken | 质押代币是否为主网基准代币 | Boolean | | \>network | 币种网络 | String | | \>chainId | 币种的链 ID | String | | \>dataType | 0：利息收益；1：矿币收益；2：手续费；3：奖励金 | String | | gainsTokenList | 收益代币列表：结构同 investWithTokenList | Array\[Struct\] | | receiveTokenInfo | 投资收到的凭证代币：结构同 investWithTokenList | Array\[Struct\] | | approveStatusList | 币种授权状态列表 | Array\[Struct\] | | \>tokenSymbol | 币种标识 | String | | \>tokenAddress | 币种的智能合约地址 | String | | \>tokenPrecision | 币种精确小数位 | String | | \>isNeedApprove | 是否需要授权 | Boolean | | \>approveAddress | 需要授权的合约地址 | String | | \>network | 币种网络 | String | | \>chainId | 币种的链 ID | String | | \>orderType | 类型透传给 Call data 的参数 (3：买入授权；4：赎回授权；8：进入 Farm；9：离开 Farm) | String | [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [查询赎回的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/calculator/subscribe-info' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "inputAmount": "1", "inputTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "isSingle": false, "tokenDecimal": "18", "investmentId": "21915", "address": "0x7f****da", "investmentType": 0 }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-investment#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "investWithTokenList": [\ {\ "tokenSymbol": "CORE",\ "tokenName": "Core",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "chainId": "1116",\ "tokenPrecision": "18",\ "isBaseToken": true,\ "coinAmount": "1",\ "currencyAmount": "0.5035"\ }\ ], "gainsTokenList": [\ {\ "tokenSymbol": "CORE",\ "tokenName": "Core",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "tokenPrecision": "18",\ "coinAmount": "0.000742226856350101",\ "dataType": "0"\ }\ ], "approveStatusList": [\ {\ "tokenSymbol": "CORE",\ "tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",\ "network": "CORE",\ "chainId": "1116",\ "tokenPrecision": "18",\ "isNeedApprove": false,\ "approveAddress": "0x0000000000000000000000000000000000001007",\ "orderType": "3"\ }\ ], "isSwapInvest": false, "estimateGasFee": "99343", "isAllowSubscribe": true, "validatorName": "OKXEarn" } } [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [查询赎回的预估计算信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation-query-info-for-redemption) --- # 查询挂单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) 查询挂单 查询挂单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing#%E6%9F%A5%E8%AF%A2%E6%8C%82%E5%8D%95) ===================================================================================================================== 该接口用于查询指定 NFT 的有效欧易 Seaport 协议挂单。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/markets/listings` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | collectionAddress | String | 否 | NFT 合约地址 | | tokenId | String | 否 | NFT 的 tokenId | | maker | String | 否 | 根据订单发起人钱包地址过滤 | | createAfter | String | 否 | 只展示此时间戳之后的创建订单，单位为秒 | | createBefore | String | 否 | 只展示此时间戳之前的创建订单，单位为秒 | | updateAfter | String | 否 | 只展示此时间戳之后的更新订单，单位为秒 | | updateBefore | String | 否 | 只展示此时间戳之前的更新订单，单位为秒 | | status | String | 否 | 根据订单状态过滤，包括（active、inactive、cancelled、sold） | | platform | String | 否 | 目标挂单平台，详情见[已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets)
，默认值为 okx | | sort | String | 否 | 订单排序规则，create\_time\_desc 代表根据订单创建时间倒序排序，update\_time\_desc 代表根据订单更新时间倒序排序，price\_desc 代表根据价格倒序排序，price\_asc 代表根据价格正序排序。排序规则默认为根据时间正序排序 | | limit | String | 否 | 单页条数限制，默认值为 50 | | cursor | String | 否 | 查询指定订单页的游标参数 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个[欧易订单模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model.html#%E6%AC%A7%E6%98%93%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | orderId | String | 订单 ID | | createTime | Long | 订单创建日期 | | updateTime | Long | 订单更新日期 | | listingTime | Long | 订单挂单时间 | | expirationTime | Long | 订单有效期，结束时间 | | status | String | 订单状态，包括 (active、cancelled、sold、inactive) | | orderHash | String | 订单 hash | | protocolData | String | 订单参数 (json) | | protocolAddress | String | 订单交易合约地址 | | chain | String | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | maker | String | 订单发起人的地址 | | orderType | String | 订单类型，Offer 代表出价单，BuyNow 代表挂单 | | price | String | 订单对应的每个 NFT 单价 | | currencyAddress | String | 订单对应的代币地址 | | collectionAddress | String | NFT 合约地址 | | tokenId | String | NFT Token ID | | amount | String | 订单对应的 NFT 数量 | [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/markets/listings?{REQUEST PARAMS}" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "NjE5MTQ0MTM5", "data": [\ {\ "amount": "1",\ "chain": "OKTC",\ "collectionAddress": "0xe4c0578279269c4f0265bc486c199509566fe863",\ "createTime": 1672828395,\ "updateTime": 1672828395,\ "status": "active",\ "currencyAddress": "0x382bb369d343125bfb2117af9c149795c6c65c50",\ "expirationTime": 1673433171,\ "listingTime": 1672828387,\ "maker": "0x5164370b3ba971474d10da1d409ce8872cb8ca97",\ "orderHash": "0x5bdaa259cb76ace593f3e631099319f955b48397482e7e4d45c008d985b61ade",\ "orderType": "BuyNow",\ "price": "1000000000000000",\ "protocolAddress": "0x34df5c035e31c0edfd104f3ea83d9548f108df56",\ "protocolData": {\ "parameters": {\ "conduitKey": "0x618Cf13c76c1FFC2168fC47c98453dCc6134F5c8888888888888888888888888",\ "consideration": [\ {\ "endAmount": "1000000000000000",\ "identifierOrCriteria": "0",\ "itemType": 1,\ "recipient": "0x5164370b3ba971474d10da1d409ce8872cb8ca97",\ "startAmount": "1000000000000000",\ "token": "0x382bb369d343125bfb2117af9c149795c6c65c50"\ }\ ],\ "counter": 0,\ "endTime": 1673433171,\ "offer": [\ {\ "endAmount": "1",\ "identifierOrCriteria": "17230",\ "itemType": 2,\ "startAmount": "1",\ "token": "0xe4c0578279269c4f0265bc486c199509566fe863"\ }\ ],\ "offerer": "0x5164370b3ba971474d10da1d409ce8872cb8ca97",\ "orderType": 2,\ "salt": "27454607645473204",\ "startTime": 1672828387,\ "totalOriginalConsiderationItems": 1,\ "zone": "0xa472fAd4B6cAdFDEd63f7aE5BFEe6eCf4F08Ae95",\ "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000"\ },\ "signature": "0x"\ },\ "tokenId": "17230"\ }\ ] }, "msg": "" } [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) --- # 合集相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [NFT 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) [资产相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) [合集相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) [订单相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) 合集相关模型 合集相关模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E7%9B%B8%E5%85%B3%E6%A8%A1%E5%9E%8B) ============================================================================================================================================ 合集用于表示单个或多个合约地址中的所有资产，并帮助用户对来自同一创建者的项目进行分组。它们有一个或多个所有者，并与创建者版税和描述等重要元数据相关联。 下面的欧易 Football Cup 是欧易上显示的合集示例。 合集模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B) ------------------------------------------------------------------------------------------------------------------------ 合集相关的全部信息 | **参数** | **类型** | **描述** | | --- | --- | --- | | name | String | 合集名称 | | des | String | 合集简介 | | image | String | 合集头像图片地址 | | backgroundImage | String | 合集背景图片地址 | | slug | String | 合集 slug 名称，即合集的唯一标识 | | certificateFlag | Boolean | 合集认证标记 | | officialWebsite | String | 合集官网地址 | | instagramUrl | String | 合集 Instagram 地址 | | discordUrl | String | 合集 Discord 地址 | | mediumUrl | String | 合集 Medium 地址 | | twitterUrl | String | 合集推特地址 | | categoryList | Array | 合集分类标签列表 | | assetContracts | Array | 与该合集相关的合约信息列表，包括合约地址，协议标准，拥有者地址，是否支持 erc2981 协议等，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%e5%90%88%e7%ba%a6%e4%bf%a1%e6%81%af%e6%a8%a1%e5%9e%8b)
数组 | | stats | Object | 该合集对应统计数据，包括交易额、地板价等，一个[合集统计信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%e5%90%88%e9%9b%86%e7%bb%9f%e8%ae%a1%e4%bf%a1%e6%81%af%e6%a8%a1%e5%9e%8b)
对象 | 合约信息模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B) -------------------------------------------------------------------------------------------------------------------------------------------- 合集相关的合约信息 | **参数** | **类型** | **描述** | | --- | --- | --- | | chain | String | 与该合集相关的合约所属链 | | contractAddress | String | 与该合集相关的合约地址 | | tokenStandard | String | 该合约对应的协议类型，例如 ERC721、ERC1155 | | ownerAddress | String | 该合约对应的拥有者地址 | | erc2981 | Boolean | 该合约是否支持 2981 协议 | 合集统计信息模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E7%BB%9F%E8%AE%A1%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B) ---------------------------------------------------------------------------------------------------------------------------------------------------------------- 合集相关统计信息 | **参数** | **类型** | **描述** | | --- | --- | --- | | latestPrice | String | 该合集的最新成交价格 | | totalVolume | String | 该合集的总交易额 | | totalCount | String | 该合集的 NFT 数量 | | ownerCount | String | 该合集的拥有者数量 | | floorPrice | String | 该合集的地板价 | [资产相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) [订单相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) 目录 [合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B) [合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B) [合集统计信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E7%BB%9F%E8%AE%A1%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B) --- # 交易授权 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 交易授权 交易授权[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction#%E4%BA%A4%E6%98%93%E6%8E%88%E6%9D%83) =============================================================================================================================== 根据 [ERC-20 Token](https://ethereum.org/en/developers/docs/standards/tokens/erc-20/) 标准，在执行兑换交易前用户需要授权欧易 DEX router 对其钱包进行资产操作，此接口提供发起授权交易前所需要的交易信息。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/dex/aggregator/approve-transaction` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数 | 类型 | 必传 | 描述 | | --- | --- | --- | --- | | chainId | String | 是 | 链 ID （如`1`: Ethereum，更多可查看[链 ID 列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks)
） | | tokenContractAddress | String | 是 | 币种合约地址 （如`0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48`） | | approveAmount | String | 是 | 执行授权的币种数量
（数量需包含精度，如授权 `1.00` USDT 需输入 `1000000`，授权 `1.00` DAI 需输入 `1000000000000000000`） | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数 | 类型 | 描述 | | --- | --- | --- | | data | String | Call data | | dexContractAddress | String | 欧易 DEX router 合约地址 （如`0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48`） | | gasLimit | String | Gas limit （如`50000`） | | gasPrice | String | 以 wei 为单位的 gas price （如`110000000`） | [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/dex/aggregator/approve-transaction?chainId=1&tokenContractAddress=0x6f9ffea7370310cd0f890dfde5e0e061059dcfd9&approveAmount=1000000' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "data": "0x095ea7b3000000000000000000000000c67879f4065d3b9fe1c09ee990b891aa8e3a4c2f00000000000000000000000000000000000000000000000000000000000f4240",\ "dexContractAddress": "0xc67879F4065d3B9fe1C09EE990B891Aa8E3a4c2f",\ "gasLimit": "50000",\ "gasPrice": "110000000"\ }\ ], "msg": "" } [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) --- # 获取币种列表 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 获取币种列表 获取币种列表[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens#%E8%8E%B7%E5%8F%96%E5%B8%81%E7%A7%8D%E5%88%97%E8%A1%A8) ========================================================================================================================================== 获取欧易 DEX 聚合器协议支持兑换的币种列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/dex/aggregator/all-tokens` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数 | 类型 | 必传 | 描述 | | --- | --- | --- | --- | | chainId | String | 是 | 链 ID (如`1`: Ethereum，更多可查看[链 ID 列表](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-supported-networks)
) | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数 | 类型 | 描述 | | --- | --- | --- | | decimals | String | 币种精度 (如: `18`) | | tokenContractAddress | String | 币种合约地址 (如: `0x382bb369d343125bfb2117af9c149795c6c65c50`) | | tokenLogoUrl | String | 币种标识 (如: `https://static.okx.com/cdn/wallet/logo/USDT-991ffed9-e495-4d1b-80c2-a4c5f96ce22d.png`) | | tokenName | String | 币种全称 (如: `Tether`) | | tokenSymbol | String | 币种简称 (如: `USDT`) | [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/dex/aggregator/all-tokens?chainId=1' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "data": [\ {\ "decimals": "18",\ "tokenContractAddress": "0x382bb369d343125bfb2117af9c149795c6c65c50",\ "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/USDT-991ffed9-e495-4d1b-80c2-a4c5f96ce22d.png",\ "tokenName": "Tether",\ "tokenSymbol": "USDT"\ },\ {\ "decimals": "18",\ "tokenContractAddress": "0xc946daf81b08146b1c7a8da2a851ddf2b3eaaf85",\ "tokenLogoUrl": "https://static.okx.com/cdn/explorer/okexchain/exchain_usdc.png",\ "tokenName": "USD Coin",\ "tokenSymbol": "USDC"\ },\ {\ "decimals": "18",\ "tokenContractAddress": "0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2",\ "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/okb.png",\ "tokenName": "OKB",\ "tokenSymbol": "OKB"\ },\ {\ "decimals": "18",\ "tokenContractAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",\ "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/okt.png",\ "tokenName": "OKTC",\ "tokenSymbol": "OKT"\ },\ {\ "decimals": "18",\ "tokenContractAddress": "0x218c3c3d49d0e7b37aff0d8bb079de36ae61a4c0",\ "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/BNB-20220308.png",\ "tokenName": "Binance Coin",\ "tokenSymbol": "BNB"\ },\ {\ "decimals": "18",\ "tokenContractAddress": "0x332730a4f6e03d9c55829435f10360e13cfa41ff",\ "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/BUSD-20220308.png",\ "tokenName": "Binance USD",\ "tokenSymbol": "BUSD"\ },\ {\ "decimals": "18",\ "tokenContractAddress": "0xdcac52e001f5bd413aa6ea83956438f29098166b",\ "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/eth_usdk.png",\ "tokenName": "USDK",\ "tokenSymbol": "USDK"\ }\ ], "msg": "" } [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) --- # 生成领取奖励金交易的调用数据 | 交易 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [生成交易前授权的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-authorization) [生成申购交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-subscription) [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [生成领取奖励金交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) 生成领取奖励金交易的调用数据 生成领取奖励金交易的调用数据[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E7%94%9F%E6%88%90%E9%A2%86%E5%8F%96%E5%A5%96%E5%8A%B1%E9%87%91%E4%BA%A4%E6%98%93%E7%9A%84%E8%B0%83%E7%94%A8%E6%95%B0%E6%8D%AE) ================================================================================================================================================================================================================================================= 描述：该 API 将提供领取奖励交易的调用数据。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/transaction/bonus`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | address | 用户钱包地址 | 请求体 | 是 | String | | investmentId | 投资品 ID | 请求体 | 是 | String | | userInputList | 用户输入代币信息 | 请求体 | 是 | Array\[Struct\] | | \>chainId | 区块链 ID (默认：投资品网络) | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 是 | String | | \>tokenAddress | 认购代币的智能合约地址 (默认：投资品代币地址) | 请求体 | 否 | String | | expectOutputLIst | 用户预期收益信息 | 请求体 | 是 | Array\[Struct\] | | \>chainId | 区块链 ID | 请求体 | 否 | String | | \>coinAmount | 认购数量 | 请求体 | 是 | String | | \>tokenAddress | 认购代币的智能合约地址 | 请求体 | 否 | String | | extra | 具体含义见备注 | 请求体 | 否 | String | ### 备注：[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E5%A4%87%E6%B3%A8%EF%BC%9A) extra 用法 领取奖励金 * a. key：claimIndex (Number)。 含义：需领取的 ID，[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) 获取。支持协议例如：Ankr、Benqi、Stader、Lido。如果返回结果字段，[这个](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) 接口可以拿到用户持仓。rewardDefiTokenInfo.claimMode 值为 1，代表有二级页，则可以调用[这个](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) 接口，得到奖励清单。领取某个奖励需要关注几个字段： * canClaimAll：能否全部领取 * rewardTokenInfos.claimIndex：标识某个奖励的 ID * callDataRewardType：1：可领取奖励；2：过期奖励；3：不可领取的奖励。Call data Extra 字段传参： 1. 如果 canClaimAll = true (目前只有 BENQI/Tranchess ) * claimIndex 长度为 1 会领取 1 个奖励； {"extra" : "{\"claimIndex\":[\"2\"]}" } * claimIndex长度大于 1 会领取所有可以领取的奖励 {"extra" : "{\"claimIndex\":[\"2\",\"3\"]}" } 2. 如果 canClaimAll = false，不支持全部领取，claimIndex 长度只能为 1 {"extra" : "{\"claimIndex\":[\"2\"]}" } 3. 如果 callDataRewardType = 2，且需要领取奖励 (仅 BENQI)，claimOverdue = true 过期也可以领取，但是会领取另外的币；默认缺省值是 false，过期则不领取，等下个领取周期再领取指定币种奖励金。 {"extra": "{\"claimOverdue\":1,\"claimIndex\":[\"2\"]}"} * b. key：analysisPlatformId (Number)。 含义：领取整个平台的奖励金，[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-product-details) 获取。支持平台包括： Compound、Aave V2、WePiggy、Venus、Aave V3、BENQI、Radiant、Geist finance、Tender、Compound V3、SonneFinance、Clearpool。 ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | dataList | Call data 数据信息 | Array\[Struct\] | | \>from | 发送地址 (用户地址) | String | | \>to | 接受地址 (目标合约地址) | String | | \>value | 转账金额 (原生代币数量，默认为空字符串 ) | String | | \>serializedData | Call data 数据 | String | | \>originalData | 原始数据 (JSON) | JSON String | | \>callDataType | 操作类型 (授权、申购、赎回、领取) | String | | \>signatureData | 签名 CallData 数据信息，可用于验证数据由欧易生成 | String | ### 备注：[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E5%A4%87%E6%B3%A8%EF%BC%9A) 验签方法： 1. 使用 signatureData 签名信息计算出 r、s、v。 2. 与 to + serializedData + originalData 拼接成的字符串计算出验签 hash。 3. 恢复公钥验证。可由接入客户选则是否验签，如果验签成功，则说明该数据由欧易签名生成。 [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) 领取协议奖励示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E9%A2%86%E5%8F%96%E5%8D%8F%E8%AE%AE%E5%A5%96%E5%8A%B1%E7%A4%BA%E4%BE%8B) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/transaction/bonus' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "address": "0x7f****da", "expectOutputList": [\ {\ "chainId": 1,\ "coinAmount": "1065142752604499571",\ "tokenAddress": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0"\ }\ ], "investmentId": "10003", "extra": "{\"claimOverdue\":0,\"claimIndex\":[\"1286\"],\"callDataExtJson\":\"\",\"redeemCalldataExtInfo\":[],\"rewardAddress\":\"\"}" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-bonus#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": { "dataList": [\ {\ "callDataType": "CLAIM",\ "from": "0x7f****da",\ "to": "0x9e****99",\ "value": "0x0",\ "serializedData": "0x46e04a2f000000000000000000000000000000000000000000000000000000000000042a",\ "originalData": "{\"callDataType\":\"CLAIM\",\"methodDefine\":\"claimTokens(uint256)\",\"methodId\":\"0x46e04a2f\",\"methodType\":\"METHOD_ID\",\"params\":{\"params\":[\"1066\"]},\"useAdapter\":false}",\ "signatureData": "e35e234d1568e13f5b7a9bd175ae947268dc3e817973120381fc8eecda78f71633ff67564c6460e388a2ca60daab62ce68f8952387e48ce63c19cad38f332c941b"\ }\ ] } } [生成赎回交易的调用数据](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction-calldata-for-redemption) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) --- # 查询用户投资品维度的持仓列表 | 用户 | API 参考 | DeFi API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-introduction) [查询信息](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore) [计算](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-calculation) [交易](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-transaction) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) [查询用户全网持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-list) [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户投资品维度的持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) [查询用户的赎回申请列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-invest-unstake-list) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DeFi API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DeFi API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [用户](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal) 查询用户投资品维度的持仓列表 查询用户投资品维度的持仓列表[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position#%E6%9F%A5%E8%AF%A2%E7%94%A8%E6%88%B7%E6%8A%95%E8%B5%84%E5%93%81%E7%BB%B4%E5%BA%A6%E7%9A%84%E6%8C%81%E4%BB%93%E5%88%97%E8%A1%A8) ========================================================================================================================================================================================================================================== 描述：该 API 将提供用户投资品维度的资产持仓列表。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST **`https://web3.okx.com/api/v5/defi/user/investment/asset-detail`** ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 参数类型 | 必传 | 数据类型 | | --- | --- | --- | --- | --- | | address | 用户钱包地址 | 请求体 | 是 | String | | chainId | 公链 ID | 请求体 | 否 | String | | investmentId | 投资品 ID (investmentId 和 poolId 不可同时为空)，[这里](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-explore-protocol-list)
获取 | 请求体 | 是 | String | | poolId | BRC-20 类型投资品所需 ID (investmentId 和 poolId 不可同时为空) | 请求体 | 否 | String | | farmInvestmentId | 挖矿类型投资品 ID，用以检测是否可用于挖矿 (仅 Uni V3 类型投资品需此条件) | 请求体 | 否 | String | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | 参数名称 | 相关描述 | 数据类型 | | --- | --- | --- | | investmentName | 投资品名称 | String | | investmentId | 投资品 ID | String | | sourceInvestmentId | 投资品来源 ID | String | | investType | 投资品类型 (1、存币；2、流动性池；3、挖矿；4、机枪池；5、质押) | String | | investName | 投资品类名称 (1、存币；2、流动性池；3、挖矿；4、机枪池；5、质押) | String | | assetsTokenList | 资产代币列表 | Array\[Struct\] | | \>tokenSymbol | 币种标识 | String | | \>tokenAddress | 币种合约地址 | String | | \>tokenPrecision | 币种精度 | String | | \>coinAmount | 币种数量 | String | | \>currencyAmount | 币种数量美元价值 | String | | rewardDefiTokenInfo | 综合赎回列表 | Array\[Struct\] | | \>baseDefiTokenInfos | 基础代币信息 | Array\[Struct\] | | \>>tokenSymbol | 币种标识 | String | | \>>tokenAddress | 币种合约地址 | String | | \>>tokenPrecision | 币种精度 | String | | \>>coinAmount | 币种数量 | String | | \>>currencyAmount | 币种数量美元价值 | String | | \>>network | 币种网络 | String | | \>rewardType | 赎回类型：1、公共；2、可赎回、3、空投；4、奖励金 | String | | totalValue | 美元价值 | String | [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location 'https://web3.okx.com/api/v5/defi/user/investment/asset-detail' \ --header 'OK-ACCESS-KEY: 9c****77' \ --header 'OK-ACCESS-PASSPHRASE: p****d' \ --header 'Content-Type: application/json' \ --data '{ "address":"0x7f****da", "investmentId":"15299", "chainId":"137" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-position#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "msg": "", "data": [\ {\ "investmentName": "Curve LP peUSD-USDC.e",\ "investmentId": "21670",\ "sourceInvestmentId": "21668",\ "investType": "3",\ "investName": "Farm",\ "assetsTokenList": [\ {\ "tokenSymbol": "peUSDUSDC-f",\ "tokenAddress": "0x1e2ebe2fffa7c9fa83486188f7c19f9acd1bb990",\ "tokenPrecision": "18",\ "coinAmount": "2.691174106339194701",\ "currencyAmount": "2.61869989433167351725360102089837"\ }\ ],\ "rewardDefiTokenInfo": [\ {\ "baseDefiTokenInfos": [\ {\ "tokenSymbol": "esLBR",\ "tokenAddress": "0x73b1988a3336208e55275c52fac7f5d3a7dfb89f",\ "network": "ARB",\ "tokenPrecision": "18",\ "coinAmount": "0.002555136460646101",\ "currencyAmount": "0.00307009284288151737625793354325",\ "buttonType": "0"\ }\ ],\ "buttonType": "3",\ "rewardType": "1"\ }\ ],\ "totalValue": "2.62176998717455503462985895444162"\ }\ ] } [查询用户协议维度持仓列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-asset-platform-detail) [查询用户的余额列表](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference-personal-query-balance) --- # 获取资产列表 | 资产 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [获取资产列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) 获取资产列表 获取资产列表[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list#%E8%8E%B7%E5%8F%96%E8%B5%84%E4%BA%A7%E5%88%97%E8%A1%A8) =============================================================================================================================================== 该接口用于获取资产所有人在指定链下持有的 NFT 资产列表，列表包括NFT详细信息，包括基础信息、合约信息和统计信息，例如地板价。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/owner/asset-list` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | contractAddress | String | 否 | 合约地址，必须是一个有效的合约地址 | | ownerAddress | String | 是 | 资产所有者的地址，必须是一个有效的所有者地址 | | cursor | String | 否 | 指向要检索的页面的游标 | | limit | String | 否 | 分页大小（默认值 10，最大 100）。返回最大的合集数 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个[资产模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model.html#%E8%B5%84%E4%BA%A7%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | name | String | NFT 的名称 | | tokenId | String | NFT 的 token ID | | amount | String | 指定 tokenId 下 NFT 的总供应量 | | tokenUri | String | NFT 的元数据地址 | | image | String | NFT 的图片地址 | | imagePreviewUrl | String | NFT 的图片预览图地址 | | imageThumbnailUrl | String | NFT 的图片缩略图地址 | | animationUrl | String | NFT 的音视频资源地址 | | attributes | Object | NFT 的特殊属性信息，一个[属性模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#%E5%B1%9E%E6%80%A7%E6%A8%A1%E5%9E%8B) | | assetContracts | Object | 合约信息，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
对象 | | collection | Object | 合集信息，一个[合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B)
对象 | | ownerAddress | String | 资产所有者的地址 | | isLazyMintType | Boolean | 是否为延迟铸币并且未发生转移 | [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/owner/asset-list" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "contractAddress=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d" \ -d "ownerAddress=0x46efbaedc92067e6d60e84ed6395099723252496" \ -d "limit=1" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-asset-list#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "MzQ2MDQ4Mg==", "data": [\ {\ "animationUrl": "",\ "assetContract": {\ "chain": "Ethereum",\ "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "erc2981": false,\ "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",\ "tokenStandard": "erc721"\ },\ "attributes": "[{\"trait_type\":\"Mouth\",\"value\":\"Grin\"},{\"trait_type\":\"Clothes\",\"value\":\"Vietnam Jacket\"},{\"trait_type\":\"Background\",\"value\":\"Orange\"},{\"trait_type\":\"Eyes\",\"value\":\"Blue Beams\"},{\"trait_type\":\"Fur\",\"value\":\"Robot\"}]",\ "collection": {\ "assetContracts": [\ {\ "chain": "Ethereum",\ "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "erc2981": false,\ "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",\ "tokenStandard": "erc721"\ }\ ],\ "backgroundImage": "https://static.coinall.ltd/cdn/nft/files/collection/205-background.png",\ "categoryList": [\ "Collectibles"\ ],\ "certificateFlag": true,\ "des": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",\ "discordUrl": "https://discord.gg/3P5K3dzgdB",\ "image": "https://static.coinall.ltd/cdn/nft/d962ef0d-1cc1-4333-b19f-fc19c7322335.jpg",\ "instagramUrl": "",\ "mediumUrl": "",\ "name": "Bored Ape Yacht Club",\ "officialWebsite": "http://www.boredapeyachtclub.com/",\ "slug": "bored-ape-yacht-club",\ "stats": {\ "floorPrice": "83119.7",\ "latestPrice": "104451.04",\ "ownerCount": "5703",\ "totalCount": "10000",\ "totalVolume": "2304507531.1537676"\ },\ "twitterUrl": "https://twitter.com/BoredApeYC"\ },\ "image": "https://static.coinall.ltd/cdn/nft/files/0acbff90-be06-4f4f-b7df-d951310735f2.webp",\ "imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/0acbff90-be06-4f4f-b7df-d951310735f2.webp/type=list",\ "imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/0acbff90-be06-4f4f-b7df-d951310735f2.webp/type=detail",\ "isLazyMintType": false,\ "name": "Bored Ape Yacht Club #1",\ "ownerAddress": "0x46efbaedc92067e6d60e84ed6395099723252496",\ "tokenId": "1",\ "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1"\ }\ ] }, "msg": "" } [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) --- # 查询特定 Tx | 交易历史 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [地址维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transactions-by-address) [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询特定 Tx](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) 查询特定 Tx 查询特定 Tx[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash#%E6%9F%A5%E8%AF%A2%E7%89%B9%E5%AE%9A-tx) ============================================================================================================================================ 根据 txHash 查询某个交易的详情。 注意 钱包 API 将一笔交易和其中的内部交易都分解成子交易，并根据变动的资产类型给出了不同的子交易类型： `0`: 外层主链币转移 `1`: 合约内层主链币转移 `2`: token转移 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/post-transaction/transaction-detail-by-txhash` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | txHash | String | Yes | 交易哈希 | | iType | String | No | EVM 交易的层级类型
`0`:外层主链币转移
`1`:合约内层主链币转移
`2`:token转移 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | chainIndex | String | 链的唯一标识 | | height | String | 交易发生的区块高度 | | txTime | String | 交易时间；Unix时间戳的毫秒数格式 | | txhash | String | 交易哈希 | | txStatus | String | 交易状态
`1`:pending 确认中
`2`:success：成功
`3`:fail：失败 | | gasLimit | String | gas限额 | | gasUsed | String | gas消耗 | | gasPrice | String | gas价格 | | txFee | String | 交易手续费 | | nonce | String | nonce | | amount | String | 交易数量 | | symbol | String | 交易数量对应的币种简称 | | methodId | String | 合约调用函数 | | fromDetails | Array | 交易输入详情 | | \>address | String | 发送/输入地址 | | \>vinIndex | String | 位于当前交易输入的序号 | | \>preVoutIndex | String | 位于上一笔输出里的序号 | | \>txhash | String | 交易哈希，和 prevoutIndex 一起唯一确认输入的 UTXO | | \> isContract | Boolean | 发送地址是否是合约地址 true:是 ；false：否 | | \> amount | String | 交易数量 | | toDetails | Array | 交易输出详情 | | \>address | String | 接收/输出地址 | | \>voutIndex | String | 输出的序号 | | \> isContract | Boolean | 接收地址是否是合约地址 true:是 ；false：否 | | \> amount | String | 交易数量 | | internalTransactionDetails | Array | 内部交易详情 | | \> from | String | 交易发送方的地址 | | \> to | String | 交易接受方的地址 | | \> isFromContract | Boolean | from地址是否是合约地址 | | \> isToContract | Boolean | to地址是否是合约地址 | | \> amount | String | 交易数量 | | \>txStatus | String | 交易状态 | | tokenTransferDetails | Array | 代币交易详情 | | \> from | String | 交易发送方的地址 | | \> to | String | 交易接受方的地址 | | \> isFromContract | Boolean | from地址是否是合约地址 | | \> isToContract | Boolean | to地址是否是合约地址 | | \> tokenContractAddress | String | 代币合约地址 | | \> symbol | String | 交易代币的简称 | | \> amount | String | 交易数量 | | l1OriginHash | String | L1执行的交易哈希 | [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/post-transaction/transaction-detail-by-txhash?txHash=0x9ab8ccccc9f778ea91ce4c0f15517672c4bd06d166e830da41ba552e744d29a5&chainIndex=42161' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-detail-by-txhash#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 以 ETH 为例 { "code": "0", "msg": "success", "data": [\ {\ "chainIndex": "42161",\ "height": "245222398",\ "txTime": "1724253417000",\ "txhash": "0x9ab8ccccc9f778ea91ce4c0f15517672c4bd06d166e830da41ba552e744d29a5",\ "gasLimit": "2000000",\ "gasUsed": "2000000",\ "gasPrice": "10000000",\ "txFee": "",\ "nonce": "0",\ "symbol": "ETH",\ "amount": "0",\ "txStatus": "success",\ "methodId": "0xc9f95d32",\ "l1OriginHash": "0xa6a87ba2f18cc32bbae8f3b2253a29a9617ed1eb0940d80443f6e3bf9873dbad",\ "fromDetails": [\ {\ "address": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "vinIndex": "",\ "preVoutIndex": "",\ "txHash": "",\ "isContract": false,\ "amount": ""\ }\ ],\ "toDetails": [\ {\ "address": "0x000000000000000000000000000000000000006e",\ "voutIndex": "",\ "isContract": false,\ "amount": ""\ }\ ],\ "internalTransactionDetails": [\ {\ "from": "0x0000000000000000000000000000000000000000",\ "to": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "isFromContract": false,\ "isToContract": false,\ "amount": "0.02",\ "state": "success"\ },\ {\ "from": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "to": "0x428ab2ba90eba0a4be7af34c9ac451ab061ac010",\ "isFromContract": false,\ "isToContract": false,\ "amount": "0.00998",\ "state": "success"\ },\ {\ "from": "0xd297fa914353c44b2e33ebe05f21846f1048cfeb",\ "to": "0x428ab2ba90eba0a4be7af34c9ac451ab061ac010",\ "isFromContract": false,\ "isToContract": false,\ "amount": "0.009977946366846017",\ "state": "success"\ }\ ],\ "tokenTransferDetails": []\ }\ ] } 以 BTC 为例 { "code": "0", "msg": "success", "data": [\ {\ "chainIndex": "0",\ "height": "858056",\ "txTime": "1724403746000",\ "txhash": "0538eec298699ff4b7cc07163c7216c48fe40caed492a3c655382bf0ae63db1a",\ "gasLimit": "",\ "gasUsed": "",\ "gasPrice": "",\ "txFee": "",\ "nonce": "",\ "symbol": "BTC",\ "amount": "",\ "txStatus": "success",\ "methodId": "",\ "l1OriginHash": "",\ "fromDetails": [\ {\ "address": "bc1py4kmmdsae08zd6jlfdkcr9gzagxrs3z5elw2hjyc5u883a8ah7ps98s0mn",\ "vinIndex": "0",\ "preVoutIndex": "1",\ "txHash": "b7b1460db2e7fff53cb1da10ad5351bd9a684668f21968a6b292dfe019605c4c",\ "isContract": false,\ "amount": "0.00001296"\ }\ ],\ "toDetails": [\ {\ "address": "bc1p7pgnqe87red4cvd7ml6rh9pl9ufpr522k2y3dpeyrvfc6g2g3r3s3ae9dr",\ "voutIndex": "0",\ "isContract": false,\ "amount": "0.00000546"\ }\ ],\ "internalTransactionDetails": [],\ "tokenTransferDetails": []\ }\ ] } [账户维度查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-transaction-list) [查询铭文交易](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-inscription-transaction-detail-by-txhash) * * * --- # 查询出价单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) 查询出价单 查询出价单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer#%E6%9F%A5%E8%AF%A2%E5%87%BA%E4%BB%B7%E5%8D%95) ============================================================================================================================= 该接口用于查询指定 NFT 的有效欧易 Seaport 协议出价单。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/markets/offers` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | collectionAddress | String | 否 | NFT 合约地址 | | tokenId | String | 否 | NFT 的 tokenId | | maker | String | 否 | 根据订单发起人钱包地址过滤 | | createAfter | String | 否 | 只展示此时间戳之后创建的订单，单位为秒 | | createBefore | String | 否 | 只展示此时间戳之前创建的订单，单位为秒 | | updateAfter | String | 否 | 只展示此时间戳之后更新的订单，单位为秒 | | updateBefore | String | 否 | 只展示此时间戳之前更新的订单，单位为秒 | | status | String | 否 | 根据订单状态过滤，包括（active、inactive、cancelled、sold） | | sort | String | 否 | 订单排序规则，create\_time\_desc 代表根据订单创建时间倒序排序，update\_time\_desc 代表根据订单更新时间倒序排序，price\_desc 代表根据价格倒序排序，price\_asc 代表根据价格正序排序。排序规则默认为根据时间正序排序 | | limit | String | 否 | 单页条数限制，默认值为50 | | cursor | String | 否 | 查询指定订单页的游标参数 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) 一个[欧易订单模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model.html#%E6%AC%A7%E6%98%93%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B) 的对象数组 | **参数** | **类型** | **描述** | | --- | --- | --- | | orderId | String | 订单 ID | | createTime | Long | 订单创建日期 | | updateTime | Long | 订单更新日期 | | listingTime | Long | 订单挂单时间 | | expirationTime | Long | 订单有效期，结束时间 | | status | String | 订单状态，包括 (active、cancelled、sold、inactive) | | orderHash | String | 订单 hash | | protocolData | String | 订单参数 (json) | | protocolAddress | String | 订单交易合约地址 | | chain | String | 链名称，包括（ETH、Polygon、AVAX、BSC、OKTC、Arbitrum One、Optimism、Klaytn、zkSync Era） | | maker | String | 订单发起人的地址 | | orderType | String | 订单类型，Offer 代表出价单，BuyNow 代表挂单 | | price | String | 订单对应的每个.NFT 单价 | | currencyAddress | String | 订单对应的代币地址 | | collectionAddress | String | NFT 合约地址 | | tokenId | String | NFT Token ID | | amount | String | 订单对应的 NFT 数量 | [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/markets/offers?{REQUEST PARAMS}" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "cursor": "ODg0MjY2NDgz", "data": [\ {\ "amount": "1",\ "chain": "eth",\ "collectionAddress": "0x457efd33def0bff2dfe33089d385898d919d3a10",\ "createTime": 1680047938,\ "currencyAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\ "expirationTime": 1680307118,\ "listingTime": 1680047927,\ "maker": "0x72fde15006cff1bfc1be596f03855a2c55b546e1",\ "orderHash": "0x48cc57480fdbe993821b6679910657845201351448bca623a6b7726fc1f7ff4b",\ "orderType": "Offer",\ "price": "110000",\ "protocolAddress": "0x90a77dd8ae0525e08b1c2930eb2eb650e78c6725",\ "protocolData": {\ "parameters": {\ "conduitKey": "0x618Cf13c76c1FFC2168fC47c98453dCc6134F5c8888888888888888888888888",\ "consideration": [\ {\ "endAmount": "1",\ "identifierOrCriteria": "77735144008553370296572895450686144694166639583550383356598452408298996120723",\ "itemType": 2,\ "recipient": "0x72fde15006cff1bfc1be596f03855a2c55b546e1",\ "startAmount": "1",\ "token": "0x457efd33def0bff2dfe33089d385898d919d3a10"\ }\ ],\ "counter": "0",\ "endTime": 1680307118,\ "offer": [\ {\ "endAmount": "110000",\ "identifierOrCriteria": "0",\ "itemType": 1,\ "startAmount": "110000",\ "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"\ }\ ],\ "offerer": "0x72fde15006cff1bfc1be596f03855a2c55b546e1",\ "orderType": 3,\ "salt": "1144075581",\ "startTime": 1680047927,\ "totalOriginalConsiderationItems": 1,\ "zone": "0x868B0635A8858dB9D984B5A27559f961Fd2736c0",\ "zoneHash": "0x0000000000000000000000000000000000000000000000000000000000000000"\ },\ "signature": "0xa413e6e3496fcd8bc28af88d4e1f2db4ccb7b524763ba6d87a56b15b20510d5d1eb782121c96ed61e2b68d537e03f96c51b37e0c325d03ad035091bf1933d4b81b"\ },\ "status": "active",\ "tokenId": "77735144008553370296572895450686144694166639583550383356598452408298996120723",\ "updateTime": 1680047938\ }\ ] }, "msg": "" } [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) --- # 查 UTXO 上铭文 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) 查 UTXO 上铭文 查 UTXO 上铭文[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail#%E6%9F%A5-utxo-%E4%B8%8A%E9%93%AD%E6%96%87) ================================================================================================================================= * 查询 Bitcoin 链，某个 UTXO 上的 Runes、BRC-20、ARC-20、Ordinals NFT 资产的数量及其详细信息。 * 查询 Fractal Bitcoin 链，某个 UTXO 上的 BRC-20 资产的数量及其详细信息。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/utxo/utxo-detail` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | chainIndex | String | Yes | 链唯一标识 | | txHash | Sring | Yes | 对应 UTXO 的交易哈希 | | voutIndex | String | Yes | 标识 UTXO 位于输出的第几位，和 txhash 一起，可以唯一映射指定的 UTXO | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | address | String | 地址 | | txhash | String | UTXO 对应的 txhash | | voutIndex | String | 标识 UTXO 位于输出的第几位，和 txhash 一起，可以唯一映射指定的 UTXO | | unresolved | Array | 返回哪些协议未完成区块解析，不确定 UTXO 内是否有对应资产 | | utxoStatus | String | UTXO 状态
`pending` ：确认中
`confrimed`：已确认
`Not found`：未找到 | | btcAssets | Array | 当前 UTXO 上的铭文资产详情，每个资产最多返回 1000 条。 | | \>protocol | String | 协议类型
`1`:BRC-20
`2`:ARC-20
`3`:Runes
`4`:ordi\_nft
`5`:SRC-20 | | \>tokenAmount | String | UTXO 上可转的代币资产数量 | | \>eventType | String | 返回 BRC-20 的具体交易事件 | | \>decimal | String | 精度，如果没有则返回为空 | | \>symbol | String | 币种名称，如果没有则返回为空 | | \>inscriptionNumber | String | 链上铸造序号 | | \>nftId | String | nft 的唯一标识，txhash+i+0，仅 Ordinals 协议支持的 BRC-20 及 Ordinals\_nft 返回 | | \>nftOffset | String | nft 位置信息 offset，铭刻在 UTXO 上的位置，仅 Ordinals 协议支持的 BRC-20 及 Ordinals\_nft 返回 | [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/utxo/utxo-detail?chainIndex=0&txHash=cd7b77b068142ee1b099a360aeb287b5e02d4603a4523cb12d18cbd58aa47985&voutIndex=0' --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "addresses": [\ "bc1p8qfrmxdlmynr076uu28vlszxavwujwe7dus0r8y9thrnp5lgfh6qu2ctrr"\ ],\ "txHash": "cd7b77b068142ee1b099a360aeb287b5e02d4603a4523cb12d18cbd58aa47985",\ "voutIndex": "0",\ "utxoStatus":"confirmed" ,\ "unresolved": [],\ "btcAssets": [\ {\ "protocol": "4",\ "tokenAmount": "",\ "eventType": "",\ "decimal": "0",\ "symbol": "",\ "inscriptionNumber": "11896131",\ "nftId": "0b7c063d14d73cdb83e3454643fc1e4a3701bd5dc2f9550e5ab303247a68f7cai0",\ "nftOffset": "0"\ }\ ]\ }\ ] } [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) --- # 获取 NFT 详情 | NFT API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [获取 NFT 详情](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details) [获取 NFT 列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) 获取 NFT 详情 获取 NFT 详情[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details#%E8%8E%B7%E5%8F%96-nft-%E8%AF%A6%E6%83%85) ====================================================================================================================================== 该接口可以用来获取 token 详情，合集信息，合约信息，以及 token 的特殊属性等。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) GET `https://web3.okx.com/api/v5/mktplace/nft/asset/detail` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | contractAddress | String | 是 | 合约地址，必须是一个有效的合约地址 | | tokenId | String | 是 | NFT 的 tokenId | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | **参数** | **类型** | **描述** | | --- | --- | --- | | name | String | NFT 的名称 | | tokenId | String | NFT 的 token ID | | tokenUri | String | NFT 的元数据地址 | | image | String | NFT 的图片地址 | | imagePreviewUrl | String | NFT 的图片预览图地址 | | imageThumbnailUrl | String | NFT 的图片缩略图地址 | | animationUrl | String | NFT 的音视频资源地址 | | attributes | Object | NFT 的特殊属性信息，一个[属性模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#%E5%B1%9E%E6%80%A7%E6%A8%A1%E5%9E%8B) | | assetContracts | Object | 合约信息，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
对象 | | collection | Object | 合集信息，一个[合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B)
对象 | [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [获取 NFT 列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/asset/detail" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d "chain=xxx" \ -d "contractAddress=xxx" \ -d "tokenId=xxx" ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-details#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": 0, "data": { "animationUrl": "", "assetContract": { "chain": "Ethereum", "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d", "erc2981": false, "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03", "tokenStandard": "erc721" }, "attributes": "[{\"trait_type\":\"Mouth\",\"value\":\"Grin\"},{\"trait_type\":\"Clothes\",\"value\":\"Vietnam Jacket\"},{\"trait_type\":\"Background\",\"value\":\"Orange\"},{\"trait_type\":\"Eyes\",\"value\":\"Blue Beams\"},{\"trait_type\":\"Fur\",\"value\":\"Robot\"}]", "collection": { "assetContracts": [\ {\ "chain": "Ethereum",\ "contractAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",\ "erc2981": false,\ "ownerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",\ "tokenStandard": "erc721"\ }\ ], "backgroundImage": "https://static.coinall.ltd/cdn/nft/files/collection/205-background.png", "categoryList": [\ "Collectibles"\ ], "certificateFlag": true, "des": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.", "discordUrl": "https://discord.gg/3P5K3dzgdB", "image": "https://static.coinall.ltd/cdn/nft/d962ef0d-1cc1-4333-b19f-fc19c7322335.jpg", "instagramUrl": "", "mediumUrl": "", "name": "Bored Ape Yacht Club", "officialWebsite": "http://www.boredapeyachtclub.com/", "slug": "bored-ape-yacht-club", "stats": { "floorPrice": "105752.05", "latestPrice": "102662.45", "ownerCount": "5666", "totalCount": "10000", "totalVolume": "2239291136.375853" }, "twitterUrl": "https://twitter.com/BoredApeYC" }, "image": "https://static.coinall.ltd/cdn/nft/files/8bd603f4-687e-4ce7-827a-c41a859b2d18.webp", "imagePreviewUrl": "https://static.coinall.ltd/cdn/nft/files/8bd603f4-687e-4ce7-827a-c41a859b2d18.webp/type=list", "imageThumbnailUrl": "https://static.coinall.ltd/cdn/nft/files/8bd603f4-687e-4ce7-827a-c41a859b2d18.webp/type=detail", "name": "Bored Ape Yacht Club #1", "tokenId": "1", "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1" }, "msg": "" } [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [获取 NFT 列表](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-nft-list) --- # NFT 相关模型 | 模型 | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [NFT 相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model) [资产相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) [合集相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model) [订单相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) NFT 相关模型 NFT 相关模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#nft-%E7%9B%B8%E5%85%B3%E6%A8%A1%E5%9E%8B) ========================================================================================================================= 欧易 API 中的主要对象是 NFT，它代表一个独特的数字项目，其所有权由区块链管理。 下面的欧易 Football Cup 是欧易上显示的 NFT 示例。 NFT模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#nft%E6%A8%A1%E5%9E%8B) --------------------------------------------------------------------------------------------------- NFT 详细信息的对象。 | **参数** | **类型** | **描述** | | --- | --- | --- | | name | String | NFT 的名称 | | tokenId | String | NFT 的 token ID | | tokenUri | String | NFT 的元数据地址 | | image | String | NFT 的图片地址 | | imagePreviewUrl | String | NFT 的图片预览图地址 | | imageThumbnailUrl | String | NFT 的图片缩略图地址 | | animationUrl | String | NFT 的音视频资源地址 | | attributes | Object | NFT 的特殊属性信息，一个[属性模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#%e5%b1%9e%e6%80%a7%e6%a8%a1%e5%9e%8b) | | assetContracts | Object | 合约信息，一个[合约信息模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model.html#%E5%90%88%E7%BA%A6%E4%BF%A1%E6%81%AF%E6%A8%A1%E5%9E%8B)
对象 | | collection | Object | 合集信息，一个[合集模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-model.html#%E5%90%88%E9%9B%86%E6%A8%A1%E5%9E%8B)
对象 | 属性模型[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#%E5%B1%9E%E6%80%A7%E6%A8%A1%E5%9E%8B) ----------------------------------------------------------------------------------------------------------------- Attributes 即代表该 NFT 所拥有的特殊属性，可能是数字或者字符串。 | **参数** | **类型** | **描述** | | --- | --- | --- | | trait\_type | String | 特殊属性的名称（比如颜色） | | value | String | 特殊属性的值（可能是字符串，也可能是数值） | | display\_type | String | 特殊属性应该如何展示（可选项可能是数字、百分比、百分比数据、日期等） | [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [资产相关模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-model) 目录 [NFT模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#nft%E6%A8%A1%E5%9E%8B) [属性模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-model#%E5%B1%9E%E6%80%A7%E6%A8%A1%E5%9E%8B) --- # 获取授权额度 | API 参考 | 限价单 API | DEX API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [获取授权额度](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) [获取币种列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-tokens) [创建限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-create-limit-order) [查询限价单列表](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-all) [取消限价单 calldata](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order-cancel) [查询限价单](https://web3.okx.com/zh-hans/build/docs/waas/dex-query-limit-order) [智能合约](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-smart-contract) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-error-code) [FAQ](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-faq) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) DEX API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) DEX API [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-reference) 获取授权额度 获取授权额度[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance#%E8%8E%B7%E5%8F%96%E6%8E%88%E6%9D%83%E9%A2%9D%E5%BA%A6) ============================================================================================================================================= Note 当前欧易 DEX 已停止提供查询交易授权额度的接口，需要用户自己采用第三方方法查询，建议方法如下。 第三方查询方法[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance#%E7%AC%AC%E4%B8%89%E6%96%B9%E6%9F%A5%E8%AF%A2%E6%96%B9%E6%B3%95) ------------------------------------------------------------------------------------------------------------------------------------------------------- ### 以 ETH chain 举例[#](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance#%E4%BB%A5-eth-chain-%E4%B8%BE%E4%BE%8B) * `Demo 为 JavaScript 语言` 1. `连接到以太坊节点`：您需要确保您已经连接到一个可用的以太坊节点。您可以使用 web3.js 或其他以太坊开发库来连接到节点。在代码中，您需要指定节点的 HTTP 或 WebSocket 端点。 2. `获取代币合约实例`：使用代币的合约地址和 ABI，您需要创建一个代币合约的实例。您可以使用 web3.js 的 web3.eth.Contract 方法来实现这一点，将合约地址和 ABI 作为参数传递给合约实例。 3. `查询授权额度`：通过调用合约实例的 allowance 函数来查询授权额度。该函数需要两个参数：拥有者的地址和被授权者的地址。您可以通过在调用时提供这两个地址来查询授权额度。 4. spenderAddress 地址可以参考 [此处](https://web3.okx.com/cn/web3/build/docs/waas/dex-limit-order-chains) 接口 Response 中的 dexTokenApproveAddress。 const { Web3 } = require('web3'); // Connect to an Ethereum node const web3 = new Web3('https://xxxxx'); // token address and ABI const tokenAddress = '0xxxxxxxxx'; // user address const ownerAddress = '0xxxxxxxx'; // ETH dex token approval address const spenderAddress = '0x40aa958dd87fc8305b97f2ba922cddca374bcd7f'; const tokenABI = [\ {\ "constant": true,\ "inputs": [\ {\ "name": "_owner",\ "type": "address"\ },\ {\ "name": "_spender",\ "type": "address"\ }\ ],\ "name": "allowance",\ "outputs": [\ {\ "name": "",\ "type": "uint256"\ }\ ],\ "payable": false,\ "stateMutability": "view",\ "type": "function"\ }\ ]; // Create token contract instance const tokenContract = new web3.eth.Contract(tokenABI, tokenAddress); // Query token approve allowance function async function getAllowance(ownerAddress, spenderAddress) { try { const allowance = await tokenContract.methods.allowance(ownerAddress, spenderAddress).call(); console.log(`Allowance for ${ownerAddress} to ${spenderAddress}: ${allowance}`); } catch (error) { console.error('Failed to query allowance:', error); } } getAllowance(ownerAddress, spenderAddress).then(r => console.log(r)); [获取支持的链](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-chains) [交易授权](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-approve-transaction) 目录 [第三方查询方法](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order-get-allowance#%E7%AC%AC%E4%B8%89%E6%96%B9%E6%9F%A5%E8%AF%A2%E6%96%B9%E6%B3%95) --- # 购买订单 | 订单 API | API 参考 | 市场 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [NFT API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-nft-api) [资产 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-asset-api) [合集 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-collection-api) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) [查询挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-listing) [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) [获取合集交易信息](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-retrieve-transaction-history) [创建挂单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-create-a-listing) [已经接入的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) [已经接入的市场](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-integrated-markets) [模型](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-models) [与不同类型合约的交互](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-types) [已部署合约](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-deployed-contract) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 市场 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 市场 API [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [订单 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-api) 购买订单 购买订单[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders#%E8%B4%AD%E4%B9%B0%E8%AE%A2%E5%8D%95) ================================================================================================================== 该接口用于购买指定的订单。 ### 请求地址[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders#%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) POST `https://web3.okx.com/api/v5/mktplace/nft/markets/buy` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) * **请求体参数** | **参数** | **类型** | **必传** | **描述** | | --- | --- | --- | --- | | chain | String | 是 | 链名称，详情见[已支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-supported-blockchains) | | walletAddress | String | 是 | 购买钱包地址 | | items | object\[\] | 是 | 一个[购买订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-order-model#%E8%B4%AD%E4%B9%B0%E8%AE%A2%E5%8D%95%E6%A8%A1%E5%9E%8B)
对象数组 | [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl -X POST "https://web3.okx.com/api/v5/mktplace/nft/markets/buy" \ -H "Content-Type: application/json" \ -H 'OK-ACCESS-KEY: XXX' \ -H 'OK-ACCESS-TIMESTAMP: XXX' \ -H 'OK-ACCESS-PASSPHRASE: XXX' \ -H 'OK-ACCESS-SIGN: XXX' \ -d '{ "chain": "bsc", "items": [\ {\ "orderId": 1440952735,\ "takeCount": 1\ },\ {\ "orderId": 1440952735,\ "takeCount": 1\ }\ ], "walletAddress": "0xb0295f8ed896413eecc1032b9f97ecc8608c55ad" }' ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-buy-orders#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code":0, "data":{ "errors":[\ ], "steps":[\ {\ "action":"ApprovalCurrency",\ "items":[\ {\ "amount":"300000000000000000",\ "approvalAddress":"0xcce3e3f79cf9091386f84610bb06947e2fc232a3",\ "chain":56,\ "currency":"USDC",\ "currencyUrl":"https://static.coinall.ltd/cdn/explorer/okexchain/exchain_usdc.png",\ "description":"Approval ERC20 to OKX",\ "kind":"erc20Approval",\ "orderIds":[\ "1156591403"\ ],\ "platform":{\ "icon":"https://static.coinall.ltd/cdn/nft/2ffcd699-3e14-4ac3-b6fc-e8e5369ab2fd.png",\ "name":"OKX",\ "source":4\ },\ "status":"complete",\ "tokenAddress":"0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d"\ }\ ]\ },\ {\ "action":"TakeOrders",\ "items":[\ {\ "chain":56,\ "contractAddress":"0xcce3e3f79cf9091386f84610bb06947e2fc232a3",\ "description":"Buy tokens on OKX",\ "input":"0x92e6f80700000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000640000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000001183e781264880a5ca05dd025967c1e6dd790e1bd425adc1d14fced1b45bf102000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000004e4e7acab24000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000004c0618cf13c76c1ffc2168fc47c98453dcc6134f5c88888888888888888888888880000000000000000000000006c7874e005654fc975c82d55830b675e9b11a09100000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000003a0000000000000000000000000000000000000000000000000000000000000042000000000000000000000000000b1f442c5a971e00599bf7858114b43fdc71347000000000000000000000000b74932867f98c4ca5099f7799cb364a6c97a07c600000000000000000000000000000000000000000000000000000000000001600000000000000000000000000000000000000000000000000000000000000220000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000645a0df00000000000000000000000000000000000000000000000000000000065475be9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b169239bd2f184618cf13c76c1ffc2168fc47c98453dcc6134f5c888888888888888888888888800000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000047b4608e69317aa2ebc71148bec5b9f65ead61e5000000000000000000000000000000000000000000000000000000000000767f00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000008ac76a51cc950d9822d68b83fe1ad97b32cd580d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000429d069189e00000000000000000000000000000000000000000000000000000429d069189e000000000000000000000000000000b1f442c5a971e00599bf7858114b43fdc713470000000000000000000000000000000000000000000000000000000000000041c66d1c598227b6fff21f06a9735b41d46a933a38512e9d9cb6b7aa4a3de851ab72ada2f67f5ddc7715d7761ba65a7447218f961a693d6f80c24447fe91e7d3a41b0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000429d069189e00000000000000000000000000008ac76a51cc950d9822d68b83fe1ad97b32cd580d00000000000000000000000047b4608e69317aa2ebc71148bec5b9f65ead61e5000000000000000000000000000000000000000000000000000000000000767f000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000003c00b1f442c5a971e00599bf7858114b43fdc713476c7874e005654fc975c82d55830b675e9b11a091000000000000000000000000000000000000000000000000",\ "kind":"transaction",\ "orderIds":[\ "1156591403"\ ],\ "platform":{\ "icon":"https://static.coinall.ltd/cdn/nft/2ffcd699-3e14-4ac3-b6fc-e8e5369ab2fd.png",\ "name":"OKX",\ "source":4\ },\ "status":"incomplete",\ "totalPrice":"0.3",\ "value":"0"\ }\ ]\ }\ ] }, "msg":"" } [查询出价单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-query-offer) [取消订单](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-cancel-orders) --- # 资产明细 | 地址维度查资产 | 链上信息查询 | 钱包 API | 钱包即服务 Web3 API Docs 文档 | OKX Wallet [![](https://web3.okx.com/cdn/assets/imgs/259/BE1AED0D895FA8ED.png?x-oss-process=image/format,webp)](https://web3.okx.com/zh-hans) [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [DApp 连接钱包](https://web3.okx.com/zh-hans/build/dev-docs/sdks/okx-wallet-integration-introduction) 主题 语言 介绍 [什么是 OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) [接入前提](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-requirement-standard) [支持的网络](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-supported-networks) 钱包 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-quickstart-intro) [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [查询支持的区块链](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-supported-blockchain) [币价和项目信息](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-tokendata) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [资产明细](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) [查询持有的 UTXO](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxos) [查 UTXO 上铭文](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-utxo-detail) [查询授权](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-get-approval-detail) [账户维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-account) [交易历史](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-post-transaction-data-api) [钱包账户管理](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-account-api) [交易广播](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-transaction-api) [签名 SDK](https://web3.okx.com/zh-hans/build/docs/waas/wallet-client-sdk) [资源](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources) DEX API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/dex-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation-root-quick-start) [兑换 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-aggregation) [跨链 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-crosschain-aggregator) [限价单 API](https://web3.okx.com/zh-hans/build/docs/waas/dex-limit-order) [DEX Widget](https://web3.okx.com/zh-hans/build/docs/waas/dex-widget-home) 市场 API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-introduction) [Runes 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-runes-api) [NFT 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-api-reference) [BTC Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-ordinals-api) [Fractal Ordinals 市场 API](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-fractal-ordinals-api) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/marketplace-error-code) DeFi API [介绍](https://web3.okx.com/zh-hans/build/docs/waas/defi-introduction) [快速开始](https://web3.okx.com/zh-hans/build/docs/waas/defi-quickstart) [API 参考](https://web3.okx.com/zh-hans/build/docs/waas/defi-api-reference) [错误码](https://web3.okx.com/zh-hans/build/docs/waas/defi-error-code) 更多资源 [接口规范](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-standard) [申请 DApp 入驻](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-resources-dapp-application) [创建移动端 App 内通用链接](https://web3.okx.com/zh-hans/build/docs/waas/app-universal-link) [更新日志](https://web3.okx.com/zh-hans/build/docs/waas/changelog) [OKX Web3 Build 用户协议](https://web3.okx.com/zh-hans/build/docs/waas/legal) 钱包 API [OKX OS](https://web3.okx.com/zh-hans/build/docs/waas/okx-waas-what-is-waas) 钱包 API [链上信息查询](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-query-api) [地址维度查资产](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-intro-asset-address) 资产明细 资产明细[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address#%E8%B5%84%E4%BA%A7%E6%98%8E%E7%BB%86) ======================================================================================================================================= 查询地址持有的多个链或指定链的 token 余额列表。 余额查询支持： * 主链币 * EVM 链的 ERC20 代币 * Bitcoin 链的 BRC-20、ARC-20、Runes 和 SRC-20 代币 * Fractal Bitcoin 链的 BRC-20 代币 此外，该接口支持过滤风险空投代币。 ### 请求路径[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address#%E8%AF%B7%E6%B1%82%E8%B7%AF%E5%BE%84) GET `https://web3.okx.com/api/v5/wallet/asset/all-token-balances-by-address` ### 请求参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0) | Parameter | Type | Required | Description | | --- | --- | --- | --- | | address | String | Yes | 地址 | | chains | String | Yes | 筛选需要查询资产明细的链，多条链以","分隔。最多支持 50 个 | | filter | String | No | `0`: 过滤风险空投币
`1`: 不过滤风险空投币
默认过滤 | ### 响应参数[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0) | Parameter | Type | Description | | --- | --- | --- | | tokenAssets | Array | 代币余额 | | \>chainIndex | String | 链唯一标识 | | \>tokenAddress | String | 合约地址 | | \>address | String | 地址 | | \>symbol | String | 代币简称 | | \>balance | String | 代币数量 | | \>rawBalance | String | 代币的原始数量。更多的链即将被支持。对于不支持的链，该字段为空。 | | \>tokenPrice | String | 币种单位价值，以美元计价 | | \>tokenType | String | 币种类型:
`1`：token
`2`：铭文 | | \>transferAmount | String | BRC-20、FBRC-20 等铭文资产可直接转账、交易的余额数量，一般称为可转余额。 | | \>availableAmount | String | BRC-20、FBRC-20 等铭文资产需要完成铭刻操作才可以交易、转账的数量，一般称为可用余额或者待铭刻余额。 | | \>isRiskToken | Boolean | `true`：命中风险空投币
`false`：未命中风险空投币 | [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) ### 请求示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B) shell curl --location --request GET 'https://web3.okx.com/api/v5/wallet/asset/all-token-balances-by-address?address=0xEd0C6079229E2d407672a117c22b62064f4a4312&chains=1&filter=1' \ --header 'Content-Type: application/json' \ --header 'OK-ACCESS-PROJECT: 86af********d1bc' \ --header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \ --header 'OK-ACCESS-SIGN: leaV********3uw=' \ --header 'OK-ACCESS-PASSPHRASE: 1****6' \ --header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ ### 响应示例[#](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-all-token-balances-by-address#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B) 200 { "code": "0", "msg": "success", "data": [\ {\ "tokenAssets": [\ {\ "chainIndex": "1",\ "tokenAddress": "0x386ae941d4262b0ee96354499df2ab8442734ec0",\ "symbol": "PT-sUSDE-27FEB2025",\ "balance": "47042180.520700015",\ "tokenPrice": "0.968391562089677097",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",\ "symbol": "wstETH",\ "balance": "7565.892480395067",\ "tokenPrice": "4321.611627695311",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",\ "symbol": "WBTC",\ "balance": "329.10055205",\ "tokenPrice": "98847.8",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x23878914efe38d27c4d67ab83ed1b93a74d4086a",\ "symbol": "aEthUSDT",\ "balance": "30057379.938443",\ "tokenPrice": "0.99978",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x657e8c867d8b37dcc18fa4caead9c45eb088c642",\ "symbol": "eBTC",\ "balance": "271.94970471",\ "tokenPrice": "99094.345321371",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x4d5f47fa6a74757f35c14fd3a6ef8e3c9bc514e8",\ "symbol": "aEthWETH",\ "balance": "6080.001975381972",\ "tokenPrice": "3634.32",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xe00bd3df25fb187d6abbb620b3dfd19839947b81",\ "symbol": "PT-sUSDE-27MAR2025",\ "balance": "19016580.895408865",\ "tokenPrice": "0.952031186961110727",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xa17581a9e3356d9a858b789d68b4d866e593ae94",\ "symbol": "cWETHv3",\ "balance": "3000.000734740809",\ "tokenPrice": "3663.74",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x9d39a5de30e57443bff2a8307a4256c8797a3497",\ "symbol": "sUSDe",\ "balance": "4863500.628333919",\ "tokenPrice": "1.144688569528375454",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xec5a52c685cc3ad79a6a347abace330d69e0b1ed",\ "symbol": "PT-LBTC-27MAR2025",\ "balance": "46.02912324",\ "tokenPrice": "97165.169717785655331396",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x8236a87084f8b84306f72007f36f2618a5634494",\ "symbol": "LBTC",\ "balance": "38.09998",\ "tokenPrice": "99187.19184268864",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xbeef047a543e45807105e51a8bbefcc5950fcfba",\ "symbol": "steakUSDT",\ "balance": "482651.8612595832",\ "tokenPrice": "1.063",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x4c9edd5852cd905f086c759e8383e09bff1e68b3",\ "symbol": "USDe",\ "balance": "69564",\ "tokenPrice": "0.99977",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x8be3460a480c80728a8c4d7a5d5303c85ba7b3b9",\ "symbol": "sENA",\ "balance": "42294.989425",\ "tokenPrice": "1.19",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "",\ "symbol": "ETH",\ "balance": "8.135546539084933",\ "tokenPrice": "3638.63",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xbf5495efe5db9ce00f80364c8b423567e58d2110",\ "symbol": "ezETH",\ "balance": "5.270854886240325",\ "tokenPrice": "3763.152404188635320082",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",\ "symbol": "DAI",\ "balance": "1196.2693184870445",\ "tokenPrice": "1.0002",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xc00e94cb662c3520282e6f5717214004a7f26888",\ "symbol": "COMP",\ "balance": "0.007643",\ "tokenPrice": "84.43345772756197",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x9abfc0f085c82ec1be31d30843965fcc63053ffe",\ "symbol": "Q*",\ "balance": "900",\ "tokenPrice": "0.000419255747329174",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xa1290d69c65a6fe4df752f95823fae25cb99e5a7",\ "symbol": "rsETH",\ "balance": "0.00007090104120006",\ "tokenPrice": "3765.640772858747921444",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x56015bbe3c01fe05bc30a8a9a9fd9a88917e7db3",\ "symbol": "CAT",\ "balance": "0.42",\ "tokenPrice": "0.06242994543936436",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xec53bf9167f50cdeb3ae105f56099aaab9061f83",\ "symbol": "EIGEN",\ "balance": "0.002496149915967488",\ "tokenPrice": "4.018538365202288",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x58d97b57bb95320f9a05dc918aef65434969c2b2",\ "symbol": "MORPHO",\ "balance": "0.001409373661132556",\ "tokenPrice": "3.3568669630371337",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xaf5191b0de278c7286d6c7cc6ab6bb8a73ba2cd6",\ "symbol": "STG",\ "balance": "0.000009547670354338",\ "tokenPrice": "0.49707759500034454",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xba3335588d9403515223f109edc4eb7269a9ab5d",\ "symbol": "GEAR",\ "balance": "0.000009005734110189",\ "tokenPrice": "0.012329598382413718",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x35fa164735182de50811e8e2e824cfb9b6118ac2",\ "symbol": "eETH",\ "balance": "0.000000000000000001",\ "tokenPrice": "3637.93",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",\ "symbol": "stETH",\ "balance": "0.000000000000000001",\ "tokenPrice": "3637.93",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xa3931d71877c0e7a3148cb7eb4463524fec27fbd",\ "symbol": "sUSDS",\ "balance": "67435907.43236613",\ "tokenPrice": "0",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xa8705a14c79fa1cded70875510211fec822b3c30",\ "symbol": "BEEX",\ "balance": "5000000",\ "tokenPrice": "0",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0xabc0abace9fb9625fcefbedc423e8f94225bd251",\ "symbol": "TANUKI",\ "balance": "3548102.746002181",\ "tokenPrice": "0",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ },\ {\ "chainIndex": "1",\ "tokenAddress": "0x356b8d89c1e1239cbbb9de4815c39a1474d5ba7d",\ "symbol": "syrupUSDT",\ "balance": "1750000",\ "tokenPrice": "0",\ "tokenType": "1",\ "isRiskToken": false,\ "transferAmount": "0",\ "availableAmount": "0",\ "rawBalance": "",\ "address": "0xed0c6079229e2d407672a117c22b62064f4a4312"\ }\ ]\ }\ ] } [总估值](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-total-token-value-address) [查询特定代币](https://web3.okx.com/zh-hans/build/docs/waas/walletapi-api-specific-token-balance-by-address) * * * --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) --- # OKX全球领先的比特币交易平台 | 比特币行情价格 | OKX Wallet ![啊哦，您似乎闯入了一个未知的区块星球](https://web3.okx.com/cdn/assets/imgs/256/32705FE41F63E763.png?x-oss-process=image/format,webp) 啊哦，您似乎闯入了一个未知的区块星球 无法找到所需页面，请返回首页查看更多内容 [返回首页](https://web3.okx.com/zh-hans) ---