Coinw合约API技能：市场数据、交易下单、止盈止损、仓位查询、账户资产

coinw-contract-skill by connectcoinw/coinw-skills

GitHub

安装命令

npx skills add https://github.com/connectcoinw/coinw-skills --skill 'Coinw Contract Skill'

区块链金融科技 API

🇨🇳中文介绍

Coinw 合约技能

Coinw 合约 REST API 技能：涵盖市场数据、下单/撤单、止盈止损、仓位和订单查询、账户资产、仓位模式和杠杆。

主要功能

市场数据：合约交易对信息、订单簿、K线数据、交易记录、保证金要求
交易与风控：下单、平仓/反向开仓、止盈止损（包括移动止盈止损）
查询与持仓：订单历史、止盈止损信息、保证金率、持仓查询
账户与通用：可划转余额、成交记录、账户资产与费率、全能金、单位换算、仓位模式、用户可用仓位大小、杠杆查询

快速参考

市场信息

序号	名称	端点	描述	方法	鉴权	输入参数	输出参数
1.1	获取交易对信息	`/v1/perpum/instruments`	查询所有交易对的基本信息，包括杠杆、保证金、止盈止损比例、挂单/吃单费率、资金费率、最大持仓量等。	GET	公开	name	base, defaultLeverage, defaultStopLossRate, defaultStopProfitRate, indexId, leverage, makerFee, maxLeverage, minLeverage, 共 37 个字段
1.2	批量获取交易对信息	`/v1/perpum/instrumentList`	批量查询多个交易对的基本信息，包括杠杆、保证金要求、费率参数和最大持仓量。	GET	公开	symbols	base, defaultLeverage, defaultStopLossRate, defaultStopProfitRate, indexId, leverage, makerFee, maxLeverage, minLeverage, 共 38 个字段

下单

序号	名称	端点	描述	方法	鉴权	输入参数	输出参数
2.1	下单	`/v1/perpum/order`	下达合约订单。支持市价单、限价单和条件单类型。	POST	私有	api_key, sign, instrument, direction, leverage, quantityUnit, quantity, positionModel, positionType, openPrice, stopProfitPrice, stopLossPrice, thirdOrderId	code, data
2.2	批量下单	`/v1/perpum/batchOrders`	批量下达合约订单，支持市价单、限价单和条件单类型。	POST	私有	api_key, sign, instrument, direction, leverage, quantityUnit, quantity, positionModel, positionType, openPrice, stopProfitPrice, stopLossPrice, triggerPrice, triggerType, thirdOrderId

查询订单

序号	名称	端点	描述	方法	鉴权	输入参数	输出参数
3.1	获取未成交订单	`/v1/perpum/orders/open`	按交易对和订单类型查询未成交订单，包括方向、数量、保证金、杠杆、费用和时间戳。	GET	私有	api_key, sign, instrument, positionType	id, userId, baseSize, createdDate, currentPiece, direction, frozenFee, indexPrice, instrument, 共 28 个字段
3.2	获取未成交订单数量	`/v1/perpum/orders/openQuantity`	返回未成交（挂单）订单的总数。挂单数据仅通过 RESTful API 提供。	GET	私有	api_key, sign	data
3.3

持仓信息

序号	名称	端点	描述	方法	鉴权	输入参数	输出参数
4.1	获取当前持仓	`/v1/perpum/positions`	按交易对查询当前开仓的持仓（已成交订单）。也可以使用一个或多个仓位 ID 查询特定持仓。	GET	私有	api_key, sign, instrument	id, base, baseSize, createdDate, currentPiece, direction, fee, fundingSettle, indexPrice, 共 37 个字段
4.2	获取历史持仓	`/v1/perpum/positions/history`	查询所有历史持仓（已成交订单），可按标的/交易对和仓位保证金模式进行筛选。	GET	私有	api_key, sign, instrument, positionModel	avgOpenPrice, completeUsdt, direction, entrustUsdt, fee, havShortfall, indexPrice, instrument, leverage, 共 22 个字段

账户与资产

序号	名称	端点	描述	方法	鉴权	输入参数	输出参数
5.1	获取最大可划转余额	`/v1/perpum/account/available`	查询合约账户可划出的最大金额。	GET	私有	api_key, sign	data.value
5.2	获取成交详情（3天）	`/v1/perpum/orders/deals`	最近 3 天的成交/资金详情（参见 api-doc 说明）。	GET	私有	api_key, sign, instrument, page, pageSize, originType, positionModel	data.rows, nextId, prevId, total
5.3	获取成交详情（3个月）

通用

序号	名称	端点	描述	方法	鉴权	输入参数	输出参数
6.1	获取杠杆信息	`/v1/perpum/positions/leverage`	查询一个已成交仓位（`positionId`）或一个未成交订单（`orderId`）的杠杆，二选一。	GET	私有	api_key, sign, positionId 或 orderId	data.value

通用参数与枚举

鉴权与 URL

基础 URL：https://api.coinw.com。
公开市场端点多为 GET https://api.coinw.com/v1/perpum/... 或 .../v1/perpumPublic/...。
私有端点需要在查询参数/请求体中包含 api_key 和 sign（MD5，参见参考文档）。

通用请求字段

instrument / name : 合约标识符（文档中常混用；指标的物/合约名称）。
symbols : 批量端点的逗号分隔列表。
layout : 0 合并持仓，1 分开持仓（与 /v1/perpum/positions/type GET/POST 中的 positionModel 一起使用）。
convertType : 1 张数 -> 币种，2 币种 -> 张数（pieceConvert）。
全能金类型（GET almightyGoldInfo） : 0 待生效到 4 发放失败；状态（POST） : 1 开启 / 关闭。

标准响应包装器（REST 中常见）

通用顶层字段：code, msg / message, success, failed, data（实际响应因端点而异）。

通用枚举与值

contractType : 通用值 1：USDT 保证金永续合约（参见 api-doc）。
positionModel : 仓位模式：0 逐仓，1 全仓（遵循 api-doc 措辞）。
quantityUnit : 订单数量单位：0 = 计价货币（例如 USDT）；1 = 合约张数；2 = 基础货币（例如 BTC）。
status : 合约状态示例：offline, online, pretest, settlement, preOffline。
priceType : 止盈止损触发价格类型：1 = 指数价格，2 = 最新价，3 = 标记价格。
processStatus : 撮合引擎处理状态：0 = 等待中，1 = 处理中，2 = 成功，3 = 失败。
selected : 默认选中状态：0 = 否，1 = 是。

示例

GET（公开端点）

curl "https://api.coinw.com/v1/perpumPublic/tickers"

需要鉴权（私有端点）

params="api_key=$COINW_API_KEY"
sign_string="$params&secret_key=$COINW_SECRET_KEY"
sign=$(echo -n "$sign_string" | openssl md5 | cut -d' ' -f2 | tr '[:lower:]' '[:upper:]')
curl -X DELETE "https://api.coinw.com/v1/perpum/allpositions&$params&sign=$sign"

安全

切勿输出完整的 api_key 或 secret_key；如果必须显示，请隐藏中间部分，仅保留最后四个字符。
在执行任何交易操作前，请征得用户确认。
将用户的 api_key 和 secret_key 存储在安全的位置。

代理行为

请求凭据时：隐藏密钥（仅显示最后 5 个字符）
列出账户时：显示名称，永不显示密钥
新凭据时：提示输入名称、签名模式

添加新账户

当用户提供新凭据时：

询问账户名称、api_key、secret_key
存储在 TOOLS.md 中，并显示隐藏后的确认信息

参考文档

鉴权./references/Authentication.md
错误码：./references/errorcode.md
说明：./references/notes.md
api-key 创建步骤：./references/api-key-creation-steps.md

每周安装次数

–

代码仓库

connectcoinw/co…w-skills

首次出现时间

–

安全审计

Gen Agent Trust HubPass SocketPass SnykFail

🇺🇸English

Coinw Contract Skill

Coinw Contract REST API skill: covers market data, order placement/cancellation, TP/SL, position and order queries, account assets, position modes, and leverage.

Key Features

Market data: contract instruments, order book, K-line data, trades, margin requirements
Trading and risk control: place orders, close/reverse positions, TP/SL (including trailing)
Queries and positions: order history, TP/SL info, margin rate, and position queries
Account and general: transferable balance, deal records, account assets and fee rates, almighty-gold, unit conversion, position mode, user available size, leverage query

Quick Reference

Market Information

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
1.1	Get instrument info	`/v1/perpum/instruments`	Queries basic information for all instruments, including leverage, margin, TP/SL ratios, maker/taker fee, funding rate, max position size, etc.

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Lark CLI IM 即时消息管理工具：机器人/用户身份操作聊天、消息、文件下载

20,000 周安装

lark-cli 共享规则：飞书资源操作指南与权限配置详解

19,900 周安装

Lark Drive API 使用指南：飞书云文档、Wiki、表格 Token 处理与文件管理

19,800 周安装

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
2.1	Place order	`/v1/perpum/order`	Places a contract order. Supports market, limit, and trigger order types.	POST	Private	api_key, sign, instrument, direction, leverage, quantityUnit, quantity, positionModel, positionType, openPrice, stopProfitPrice, stopLossPrice, thirdOrderId	code, data
2.2	Batch place orders	`/v1/perpum/batchOrders`	Batch places contract orders with support for market, limit, and trigger order types.	POST	Private	api_key, sign, instrument, direction, leverage, quantityUnit, quantity, positionModel, positionType, openPrice, stopProfitPrice, stopLossPrice, triggerPrice, triggerType, thirdOrderId	code, openId, thirdOrderId
2.3	Close position	`/v1/perpum/positions`	Partially or fully closes an open contract position (filled order). Supports closing by fixed size or by position percentage.	DELETE	Private	api_key, sign, id, positionType, closeNum, orderPrice	data
2.4	Batch close positions	`/v1/perpum/batchClose`	Closes multiple positions at market price in batch using `thirdOrderId` values.	DELETE	Private	api_key, sign, thirdOrderId	openId, thirdOrderId
2.5	Market close all positions	`/v1/perpum/allpositions`	Closes all positions for the specified instrument at market price.	DELETE	Private	api_key, sign	—
2.6	Reverse position	`/v1/perpum/positions/reverse`	Instantly reverses an existing perpetual position by closing it and opening the same size in the opposite direction.	POST	Private	api_key, sign, id	data
2.7	Adjust margin	`/v1/perpum/positions/margin`	Adjusts margin for an existing position (filled order) by increasing or decreasing margin amount.	POST	Private	api_key, sign, id, addMargin	msg
2.8	Set TP/SL	`/v1/perpum/TPSL`	Sets take-profit (TP) and stop-loss (SL) for filled or unfilled orders.	POST	Private	api_key, sign, id, instrument, stopProfitPrice, stopLossPrice	msg
2.9	Set trailing TP/SL	`/v1/perpum/moveTPSL`	Configures trailing TP/SL by callback rate. Applies to filled orders only.	POST	Private	api_key, sign, openId, callbackRate, quantity, quantityUnit	—
2.10	Batch set TP/SL	`/v1/perpum/addTpsl`	Batch sets TP/SL for contract trading orders.	POST	Private	api_key, sign, id, instrument, stopLossPrice, stopProfitPrice, priceType, stopFrom, stopType, closePiece	msg
2.11	Batch update TP/SL	`/v1/perpum/updateTpsl`	Batch modifies TP/SL orders for contract trading.	POST	Private	api_key, sign, id, instrument, stopLossPrice, stopProfitPrice, priceType, stopFrom, stopType, closePiece	msg
2.12	Modify order	`/v1/perpum/order`	Modifies an unfilled order. Some fields (for example margin and leverage) cannot be changed via this endpoint.	PUT	Private	api_key, sign, id, instrument, direction, leverage, quantityUnit, quantity, positionModel, positionType, openPrice, stopProfitPrice, stopLossPrice, triggerPrice, triggerType	originId, editId
2.13	Cancel order	`/v1/perpum/order`	Cancels an unfilled order by order ID.	DELETE	Private	api_key, sign, id	msg
2.14	Cancel batch orders	`/v1/perpum/batchOrders`	Cancels multiple unfilled orders in batch.	DELETE	Private	api_key, sign, sourceIds	—

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
3.1	Get open orders	`/v1/perpum/orders/open`	Queries unfilled orders by instrument and order type, including direction, quantity, margin, leverage, fees, and timestamps.	GET	Private	api_key, sign, instrument, positionType	id, userId, baseSize, createdDate, currentPiece, direction, frozenFee, indexPrice, instrument, and 28 total fields
3.2	Get open order count	`/v1/perpum/orders/openQuantity`	Returns total number of unfilled (pending) orders. Pending order data is available via RESTful API only.	GET	Private	api_key, sign	data
3.3	Get TP/SL info	`/v1/perpum/TPSL`	Queries TP/SL information for both filled and unfilled contract orders.	GET	Private	api_key, sign, openId, stopFrom	currentPiece, closePiece, direction, createdDate, updatedDate, id, indexPrice, instrument, leverage, and 24 total fields
3.4	Get trailing TP/SL info	`/v1/perpum/moveTPSL`	Queries trailing TP/SL details for contract trading.	GET	Private	api_key, sign	baseSize, callbackRate, createdDate, currentPiece, direction, fee, instrument, leverage, margin, and 31 total fields
3.5	Get history orders (7 days)	`/v1/perpum/orders/history`	Returns historical order records from the last 7 days with pagination and filters.	GET	Private	api_key, sign, page, pageSize, originType, instrument	userId, baseSize, completeUsdt, createdDate, currentPiece, direction, entrustUsdt, havShortfall, hedgeId, and 37 total fields
3.6	Batch get history orders (7 days)	`/v1/perpum/orders/batchInsHistory`	Returns historical order records from the last 7 days with batch query via `symbols`.	GET	Private	api_key, sign, page, pageSize, originType, symbols	userId, baseSize, completeUsdt, createdDate, currentPiece, direction, entrustUsdt, havShortfall, hedgeId, and 37 total fields
3.7	Get history orders (3 months)	`/v1/perpum/orders/archive`	Returns historical order records from the last 3 months with pagination and filters.	GET	Private	api_key, sign, page, pageSize, originType, instrument	userId, baseSize, completeUsdt, createdDate, currentPiece, direction, entrustUsdt, havShortfall, hedgeId, and 37 total fields
3.8	Batch get history orders (3 months)	`/v1/perpum/orders/batchInsArchive`	Returns historical order records from the last 3 months with batch query via `symbols`.	GET	Private	api_key, sign, page, pageSize, originType, symbols	userId, baseSize, completeUsdt, createdDate, currentPiece, direction, entrustUsdt, havShortfall, hedgeId, and 37 total fields
3.9	Get order info	`/v1/perpum/order`	Returns current unfilled order information. You can query by order ID list; if no instrument/order IDs are specified, all orders under the given order type are returned.	GET	Private	api_key, sign, positionType, sourceIds	id, baseSize, contractType, userId, fee, createdDate, currentPiece, direction, frozenFee, and 35 total fields

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
5.1	Get max transferable balance	`/v1/perpum/account/available`	Queries max amount transferable out from the contract account.	GET	Private	api_key, sign	data.value
5.2	Get deal details (3 days)	`/v1/perpum/orders/deals`	Deal/funding details for the recent 3 days (see api-doc notes).	GET	Private	api_key, sign, instrument, page, pageSize, originType, positionModel	data.rows, nextId, prevId, total
5.3	Get deal details (3 months)	`/v1/perpum/orders/deals/history`	Deal/funding details for the recent 3 months (same fields as 5.2).	GET	Private	api_key, sign, instrument, page, pageSize, originType, positionModel	data.rows, nextId, prevId, total
5.4	Get contract account assets	`/v1/perpum/account/getUserAssets`	Returns available margin, USDT, frozen amounts, almighty-gold, and related fields (note meaning of `availableMargin`).	GET	Private	api_key, sign	availableMargin, availableUsdt, alMargin, alFreeze, almightyGold, userId, time
5.5	Get contract account fees	`/v1/perpum/account/fees`	Queries maker/taker fee rates.	GET	Private	api_key, sign	makerFee, takerFee, userId
5.6	Get almighty-gold balance	`/v1/perpum/account/almightyGoldInfo`	Filters almighty-gold records by status and other criteria (GET).	GET	Private	api_key, sign, type, startTime?, endTime?	data[] (id, currentAmount, totalAmount, type, etc.)
5.7	Unit conversion	`/v1/perpum/pieceConvert`	Converts between contract pieces and coin amount.	POST	Private	api_key, sign, convertType, faceValue, dealPiece?/baseSize?	data.value
5.8	Get position mode	`/v1/perpum/positions/type`	Queries isolated/cross mode and merged/split layout (GET).	GET	Private	api_key, sign	layout, positionModel
5.9	Set position mode	`/v1/perpum/positions/type`	Sets isolated/cross mode and layout (POST); there must be no open orders before switching.	POST	Private	api_key, sign, positionModel, layout	data (TRANSACTION_SUCCESS)
5.10	Enable/disable almighty-gold	`/v1/perpum/account/almightyGoldInfo`	Enables or disables almighty-gold (POST on same path as 5.6).	POST	Private	api_key, sign, status	code, msg
5.11	Get user max available contract size	`/v1/perpum/orders/availSize`	Returns available buy/sell size from the filled-position perspective (different from 4.4 maxSize use case).	GET	Private	api_key, sign, instrument	availBuy, availSell

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
4.1	Get current positions	`/v1/perpum/positions`	Queries currently open positions (filled orders) by instrument. You can also query specific positions using one or more position IDs.	GET	Private	api_key, sign, instrument	id, base, baseSize, createdDate, currentPiece, direction, fee, fundingSettle, indexPrice, and 37 total fields
4.2	Get historical positions	`/v1/perpum/positions/history`	Queries all historical positions (filled orders), with optional filtering by base/instrument and position margin mode.	GET	Private	api_key, sign, instrument, positionModel	avgOpenPrice, completeUsdt, direction, entrustUsdt, fee, havShortfall, indexPrice, instrument, leverage, and 22 total fields
4.3	Get position margin rate	`/v1/perpum/positions/marginRate`	Queries margin rate for a position (filled order) by position ID.	GET	Private	api_key, sign, positionId	data
4.4	Get max contract size	`/v1/perpum/orders/maxSize`	Queries max available contract size (long/short) by instrument, leverage, and position mode. Optional opening price can be provided.	GET	Private	api_key, sign, leverage, instrument, positionModel, orderPrice	maxBuy, maxSell
4.5	Get all current positions	`/v1/perpum/positions/all`	Queries all currently open positions (filled orders).	GET	Private	api_key, sign	id, base, baseSize, createdDate, currentPiece, closedPiece, direction, fee, fundingSettle, and 30 total fields

Coinw合约API技能：市场数据、交易下单、止盈止损、仓位查询、账户资产

🇨🇳中文介绍

Coinw 合约技能

主要功能

快速参考

市场信息

下单

查询订单

持仓信息

账户与资产

通用

通用参数与枚举

鉴权与 URL

通用请求字段

标准响应包装器（REST 中常见）

通用枚举与值

示例

GET（公开端点）

需要鉴权（私有端点）

安全

代理行为

添加新账户

参考文档

🇺🇸English

Coinw Contract Skill

Key Features

Quick Reference

Market Information

相关 Skills

Place Orders

Query Orders

Position Information

Account and Assets

General

Common Parameters and Enums

Auth and URL

Common request fields

Standard response wrapper (common in REST)

Common enums and values

Examples

GET (public endpoint)

Auth required (private endpoint)

Security

Agent Behavior

Adding New Accounts

Reference

最新 Skills