Coinw 现货 API 技能：市场数据、交易下单、订单查询与账户管理 REST API 指南

coinw-spot-skill by connectcoinw/coinw-skills

GitHub

安装命令

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

区块链金融科技 API

🇨🇳中文介绍

Coinw 现货技能

Coinw 现货 REST API 技能：涵盖市场数据、下单/撤单、订单查询、账户余额和资产划转。

主要功能

市场数据：交易对、24小时汇总、订单簿、最近成交、K线数据、热门交易量统计
交易操作：下单、撤单 / 撤销所有订单
查询和账户：订单查询、交易历史、现货余额、资产划转

快速参考

市场信息

编号	名称	端点	描述	方法	认证	输入参数	输出参数
1.1	获取交易对信息	`/api/v1/public?command=returnSymbol`	返回所有现货交易对的详细信息，包括最小/最大订单价格、数量限制和精度。	GET	公开	—	currencyPair, currencyBase, currencyQuote, maxBuyCount, minBuyCount, pricePrecision, countPrecision, minBuyAmount, maxBuyAmount，共 12 个字段
1.2	获取所有交易对 24 小时行情汇总	`/api/v1/public?command=returnTicker`	返回所有可用交易对的 24 小时汇总指标，包括最新价格、最佳买/卖价和交易量。	GET	公开	—	id, last, lowestAsk, highestBid, percentChange, isFrozen, high24hr, low24hr, baseVolume

下单

编号	名称	端点	描述	方法	认证	输入参数	输出参数
2.1	下单	`/api/v1/private?command=doTrade`	通过指定订单类型、数量、价格和外部订单 ID 来下现货订单。	POST	私有	api_key, sign, symbol, type, amount, rate, isMarket, out_trade_no	orderNumber
2.2	撤单	`/api/v1/private?command=cancelOrder`	根据订单 ID 撤销未成交的现货订单。	POST	私有	api_key, sign, orderNumber	clientOrderId
2.3

查询订单

编号	名称	端点	描述	方法	认证	输入参数	输出参数
3.1	获取未成交订单	`/api/v1/private?command=returnOpenOrders`	返回指定交易对的所有当前未成交订单，包括订单 ID、时间、数量和状态。	POST	私有	api_key, sign, currencyPair, startAt, endAt	orderNumber, date, startingAmount, total, type, prize, success_count, success_amount, status
3.2	获取历史订单	`/api/v1/private?command=getUserTrades`	检索跨交易对的历史订单，可选择按交易对筛选。每次请求最多 100 条记录。	POST	私有	api_key, sign, symbol	tradeId, orderId, price, size, side, orderType, time, fee, before，共 10 个字段

账户信息

编号	名称	端点	描述	方法	认证	输入参数	输出参数
4.1	获取现货账户余额	`/api/v1/private?command=returnBalances`	检索用户现货账户中所有支持资产的可用余额。	POST	私有	api_key, sign	data, msg
4.2	获取完整现货余额	`/api/v1/private?command=returnCompleteBalances`	检索完整的现货余额详情，包括可用余额和订单冻结余额。	POST	私有	api_key, sign	data, available, onOrders
4.7	资产划转

通用参数和枚举

认证和 URL

基础 URL：https://api.coinw.com。
公开 REST：GET/POST https://api.coinw.com/api/v1/public?command=...。
私有 REST：通常为 POST https://api.coinw.com/api/v1/private?command=...，在查询/请求体中包含 api_key 和 sign（MD5，见参考）。
部分文档同时显示 /v1/private?command=... 和 /api/v1/private；请遵循实际实现。

`command` 值（本文件涵盖的私有/公开端点）

通用请求字段

symbol / currencyPair ：交易对，例如 BTC_USDT（字段名因端点而异）。
isMarket ：与市价单相关；type ：订单类型；rate / amount / funds ：价格、数量或金额（见下单部分）。

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

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

通用枚举

failed ：true/false；指示请求是否失败。
isFrozen ：冻结状态：0 = 否，1 = 是。
side ：BUY/SELL
state ：交易对状态：1 = 活跃，2 = 禁用。
status ：1 = 未成交，2 = 部分成交，3 = 完全成交，4 = 用户取消；订单状态也可能包括 5 = 已触发，6 = 触发失败。
success ：true/false；指示请求是否成功。
type （订单，例如在批量历史中）：LIMIT, MARKET, HL_LIMIT, PLANNING, STOP_LIMIT_ORDER, SMART_MARKET_ORDER, ICEBERG 等。

示例

GET（公开端点）

curl "https://api.coinw.com/api/v1/public?command=returnSymbol"

需要认证（私有端点）

params="api_key=$COINW_API_KEY&amount=0.001&funds=1&isMarket=1&out_trade_no=1&rate=40000&symbol=BTC_USDT"
sign_string="$params&secret_key=$COINW_SECRET_KEY"
sign=$(echo -n "$sign_string" | openssl md5 | cut -d' ' -f2 | tr '[:lower:]' '[:upper:]')
curl -X POST "https://api.coinw.com/api/v1/private?command=doTrade&$params&sign=$sign"

安全

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

代理行为

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

添加新账户

当用户提供新凭据时：

询问账户名称
存储在 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 SnykWarn

🇺🇸English

Coinw Spot Skill

Coinw Spot REST API skill: covers market data, order placement/cancellation, order queries, account balances, and asset transfers.

Key Features

Market data: trading pairs, 24h summary, order book, recent trades, K-line data, hot volume stats
Trading actions: place order, cancel order / cancel all orders
Query and account: order query, trade history, spot balances, asset transfer

Quick Reference

Market Information

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
1.1	Get trading pair information	`/api/v1/public?command=returnSymbol`	Returns detailed information for all spot pairs, including min/max order price, quantity limits, and precision.	GET	Public	—

广告位招租

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

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

联系我们

相关 Skills

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

4,000,000 周安装

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

20,000 周安装

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

19,800 周安装

飞书OpenAPI Explorer：探索和调用未封装的飞书原生API接口

19,800 周安装

returnTradeHistory

returnUTradeHistory

spotWealthTransfer

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
2.1	Place order	`/api/v1/private?command=doTrade`	Places a spot order by specifying order type, amount, price, and external order ID.	POST	Private	api_key, sign, symbol, type, amount, rate, isMarket, out_trade_no	orderNumber
2.2	Cancel order	`/api/v1/private?command=cancelOrder`	Cancels an unfilled spot order by order ID.	POST	Private	api_key, sign, orderNumber	clientOrderId
2.3	Cancel all orders	`/api/v1/private?command=cancelAllOrder`	Cancels all unfilled orders for a specified trading pair.	POST	Private	api_key, sign, currencyPair	msg

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
3.1	Get open orders	`/api/v1/private?command=returnOpenOrders`	Returns all current unfilled orders for a specified pair, including order ID, time, amount, and status.	POST	Private	api_key, sign, currencyPair, startAt, endAt	orderNumber, date, startingAmount, total, type, prize, success_count, success_amount, status
3.2	Get historical orders	`/api/v1/private?command=getUserTrades`	Retrieves historical orders across pairs, with optional symbol filtering. Up to 100 records per request.	POST	Private	api_key, sign, symbol	tradeId, orderId, price, size, side, orderType, time, fee, before, and 10 total fields
3.3	Batch get historical orders	`/v1/private?command=getBatchHistoryOrders`	Batch query historical orders (last 3 months) by order ID list (see api-doc 3.3 for details).	POST	Private	api_key, sign, orderIds	data, orderId, date, side, type, dealSize, dealFunds, dealAvgPrice, fee, and 16 total fields
3.4	Get order details	`/api/v1/private?command=returnOrderTrades`	Returns detailed information for a specified order ID.	POST	Private	api_key, sign, orderNumber	tradeID, currencyPair, type, amount, success_amount, total, success_total, fee, date, and 10 total fields
3.5	Get order status	`/api/v1/private?command=returnOrderStatus`	Queries order status by order ID, including pair, side, amount, execution status, and timestamp.	POST	Private	api_key, sign, orderNumber	currencyPair, type, total, startingAmount, status, date
3.6	Get trade history	`/api/v1/private?command=returnUTradeHistory`	Returns trade history records for a specified pair.	POST	Private	api_key, sign, currencyPair	tradeID, type, amount, success_amount, total, success_count, fee, prize, date, and 11 total fields

No.	name	Endpoint	Description	Method	Authentication	Input Parameters	Output Parameters
4.1	Get spot account balance	`/api/v1/private?command=returnBalances`	Retrieves available balances in the user's spot account across supported assets.	POST	Private	api_key, sign	data, msg
4.2	Get complete spot balances	`/api/v1/private?command=returnCompleteBalances`	Retrieves full spot balance details, including available balances and order-frozen balances.	POST	Private	api_key, sign	data, available, onOrders
4.7	Asset transfer	`/api/v1/private?command=spotWealthTransfer`	Transfers assets between the spot account and funding account for fund management.	POST	Private	api_key, sign, accountType, targetAccountType, bizType, coinCode, amount	data, msg

Common Parameters and Enums

Base URL: https://api.coinw.com.
Public REST: GET/POST https://api.coinw.com/api/v1/public?command=....
Private REST: usually POST https://api.coinw.com/api/v1/private?command=..., with api_key and sign (MD5, see Reference) in query/body.
Some docs show /v1/private?command=... alongside /api/v1/private; follow actual implementation.

`command` values (private/public endpoints covered in this file)

cancelAllOrder, cancelOrder, doTrade, getBatchHistoryOrders, getUserTrades, return24hVolume, returnBalances, returnChartData, returnCompleteBalances, returnOpenOrders, returnOrderBook, returnOrderStatus, returnOrderTrades, returnSymbol, returnTicker, returnTradeHistory, returnUTradeHistory, spotWealthTransfer

Common request fields

symbol / currencyPair : trading pair, for example BTC_USDT (field names vary by endpoint).
isMarket : market-order related; type : order type; rate / amount / funds : price, quantity, or amount (see order placement section).

Standard response wrapper (common in REST)

Common top-level fields: code, msg / message, success, failed, data (actual response varies by endpoint).

failed : true/false; indicates whether request failed.
isFrozen : freeze status: 0 = no, 1 = yes.
side ：BUY/SELL
state : pair status: 1 = active, 2 = disabled.
status : 1 = unfilled, 2 = partially filled, 3 = fully filled, 4 = user canceled; order status may also include 5 = triggered, 6 = trigger failed.
success : true/false; indicates whether request succeeded.
type (orders, such as in batch history): LIMIT, MARKET, HL_LIMIT, PLANNING, STOP_LIMIT_ORDER, SMART_MARKET_ORDER, ICEBERG, etc.

GET (public endpoint)

curl "https://api.coinw.com/api/v1/public?command=returnSymbol"

Auth required (private endpoint)

params="api_key=$COINW_API_KEY&amount=0.001&funds=1&isMarket=1&out_trade_no=1&rate=40000&symbol=BTC_USDT"
sign_string="$params&secret_key=$COINW_SECRET_KEY"
sign=$(echo -n "$sign_string" | openssl md5 | cut -d' ' -f2 | tr '[:lower:]' '[:upper:]')
curl -X POST "https://api.coinw.com/api/v1/private?command=doTrade&$params&sign=$sign"

Never output full api_key or secret_key; if shown, mask the middle and keep only the last four characters.
Ask for user confirmation before any trade action.
Store user api_key and secret_key in a secure location.

Credentials requested: Mask secrets (show last 5 chars only)
Listing accounts: Show names never keys
New credentials: Prompt for name, signing mode

When user provides new credentials:

Ask for account name
Store in TOOLS.md with masked display confirmation

Authentication./references/Authentication.md
errorcode: ./references/errorcode.md
notes: ./references/notes.md
api-key create steps: ./references/api-key-creation-steps.md

飞书视频会议CLI工具：lark-vc技能详解，高效搜索与管理会议记录与纪要

19,000 周安装

Coinw 现货 API 技能：市场数据、交易下单、订单查询与账户管理 REST API 指南

🇨🇳中文介绍

Coinw 现货技能

主要功能

快速参考

市场信息

下单

查询订单

账户信息

通用参数和枚举

认证和 URL

command 值（本文件涵盖的私有/公开端点）

通用请求字段

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

通用枚举

示例

GET（公开端点）

需要认证（私有端点）

安全

代理行为

添加新账户

参考

🇺🇸English

Coinw Spot Skill

Key Features

Quick Reference

Market Information

相关 Skills

Place Orders

Query Orders

Account Information

Common Parameters and Enums

Auth and URL

command values (private/public endpoints covered in this file)

Common request fields

Standard response wrapper (common in REST)

Common enums

Examples

GET (public endpoint)

Auth required (private endpoint)

Security

Agent Behavior

Adding New Accounts

Reference

最新 Skills

`command` 值（本文件涵盖的私有/公开端点）

`command` values (private/public endpoints covered in this file)