CoinOS Market

Crypto market data toolkit powered by AiCoin Open API. Prices, K-lines, news, signals, whale orders, and more from 200+ exchanges.

Version: 1.0.0

Critical Rules

NEVER fabricate data. Always run scripts to fetch real-time data.
NEVER use curl, web_fetch, or browser for crypto data. Always use these scripts.
NEVER run
env
or
printenv
— leaks API secrets into logs.
Scripts auto-load
.env
— never pass credentials inline.
Reply in the user's language. Chinese input = all-Chinese response (titles, headings, analysis).
On 304/403 error — STOP, do NOT retry. This is a paid feature. Follow the Paid Feature Guide to help the user upgrade.

Quick Reference

Task	Command	Min Tier
BTC price	`node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin"}'`	Free
K-line	`node scripts/market.mjs kline '{"symbol":"btcusdt:okex","period":"3600","size":"100"}'`	Free
Funding rate	`node scripts/coin.mjs funding_rate '{"symbol":"BTC"}'`	Basic
Long/short ratio	`node scripts/features.mjs ls_ratio`	Basic
Whale orders	`node scripts/features.mjs big_orders '{"symbol":"btcswapusdt:binance"}'`	Standard
News flash	`node scripts/news.mjs flash_list '{"language":"cn"}'`	Basic
Trending coins	`node scripts/market.mjs hot_coins '{"key":"defi"}'`	Free
Open interest	`node scripts/coin.mjs open_interest '{"symbol":"BTC","interval":"15m"}'`	Professional
Liquidation map	`node scripts/coin.mjs liquidation_map '{"dbkey":"btcswapusdt:binance","cycle":"24h"}'`	Advanced

Symbol shortcuts:

BTC

ETH

SOL

DOGE

XRP

auto-resolve in coin.mjs.

Chinese Slang: 大饼=BTC, 姨太=ETH, 狗狗=DOGE, 瑞波=XRP, 索拉纳=SOL.

Free vs Paid Endpoints

Free (built-in key, no config needed):

coin_ticker

kline

hot_coins

exchanges

pair_ticker

news_rss

— only 6 endpoints.

Basic ($29/mo) adds:

coin_list

coin_config

funding_rate

trade_data

ticker

futures_interest

ls_ratio

nav

pair_by_market

pair_list

news_list

flash_list

twitter/latest

twitter/search

newsflash/search

newsflash/list

Standard ($79/mo) adds:

big_orders

agg_trades

grayscale_trust

gray_scale

signal_alert

signal_config

strategy_signal

change_signal

depth_latest

newsflash

news_detail

twitter/members

twitter/interaction_stats

newsflash/detail

Advanced ($299/mo) adds:

liquidation_map

liquidation_history

liquidation

indicator_kline

indicator_pairs

index_list

index_price

index_info

depth_full

depth_grouped

Professional ($699/mo) adds:

ai_analysis

open_interest

estimated_liquidation

historical_depth

super_depth

funding_rate

(weighted),

stock_quotes

stock_top_gainer

stock_company

treasury_*

stock_market

signal_alert_list

exchange_listing

Full tier table:

docs/api-tiers.md

Setup

Scripts work out of the box with a built-in free key (6 endpoints). For more endpoints, add your API key to

.env

AICOIN_ACCESS_KEY_ID=your-key
AICOIN_ACCESS_SECRET=your-secret

.env

is auto-loaded from: cwd →

~/.openclaw/workspace/.env

→

~/.openclaw/.env

Scripts

All scripts:

node scripts/<name>.mjs <action> [json-params]

scripts/coin.mjs — Coin Data

Action	Description	Min Tier	Params
`coin_ticker`	Real-time prices	Free	`{"coin_list":"bitcoin,ethereum"}`
`coin_list`	List all coins	Basic	None
`coin_config`	Coin profile	Basic	`{"coin_list":"bitcoin"}`
`funding_rate`	Funding rate	Basic	`{"symbol":"BTC","interval":"8h"}` Weighted: add `"weighted":"true"` (Pro)
`trade_data`	Trade data	Basic	`{"dbkey":"btcswapusdt:okcoinfutures"}`
`ai_analysis`	AI analysis & prediction	Pro	`{"coin_keys":"[\"bitcoin\"]","language":"CN"}`
`open_interest`	Open interest	Pro	`{"symbol":"BTC","interval":"15m"}` Coin-margined: add `"margin_type":"coin"`
`liquidation_map`	Liquidation heatmap	Adv	`{"dbkey":"btcswapusdt:binance","cycle":"24h"}`
`liquidation_history`	Liquidation history	Adv	`{"symbol":"btcswapusdt:binance","interval":"1m"}`
`estimated_liquidation`	Estimated liquidation	Pro	`{"dbkey":"btcswapusdt:binance","cycle":"24h"}`
`historical_depth`	Historical depth	Pro	`{"key":"btcswapusdt:okcoinfutures"}`
`super_depth`	Large order depth >$10k	Pro	`{"key":"btcswapusdt:okcoinfutures"}`

scripts/market.mjs — Market Data

Action	Description	Min Tier	Params
`kline`	Standard K-line	Free	`{"symbol":"btcusdt:okex","period":"3600","size":"100"}` period: 900/3600/14400/86400
`hot_coins`	Trending coins	Free	`{"key":"defi"}` key: gamefi/anonymous/market/web/newcoin/stable/defi
`exchanges`	Exchange list	Free	None
`ticker`	Exchange tickers	Basic	`{"market_list":"okex,binance"}`
`futures_interest`	Futures OI ranking	Basic	`{"lan":"cn"}`
`depth_latest`	Real-time depth	Std	`{"dbKey":"btcswapusdt:binance"}`
`indicator_kline`	Indicator K-line	Adv	`{"symbol":"btcswapusdt:binance","indicator_key":"fundflow","period":"3600"}`
`indicator_pairs`	Indicator pairs	Adv	`{"indicator_key":"fundflow"}`
`index_list`	Index list	Adv	None
`index_price`	Index price	Adv	`{"key":"i:diniw:ice"}`
`index_info`	Index details	Adv	`{"key":"i:diniw:ice"}`
`depth_full`	Full order book	Adv	`{"dbKey":"btcswapusdt:binance"}`
`depth_grouped`	Grouped depth	Adv	`{"dbKey":"btcswapusdt:binance","groupSize":"100"}`
`stock_quotes`	Stock quotes	Pro	`{"tickers":"i:mstr:nasdaq"}`
`stock_top_gainer`	Top gainers	Pro	`{"us_stock":"true"}`
`stock_company`	Company details	Pro	`{"symbol":"i:mstr:nasdaq"}`
`treasury_entities`	Holding entities	Pro	`{"coin":"BTC"}`
`treasury_history`	Transaction history	Pro	`{"coin":"BTC"}`
`treasury_accumulated`	Accumulated holdings	Pro	`{"coin":"BTC"}`
`treasury_latest_entities`	Latest entities	Pro	`{"coin":"BTC"}`
`treasury_latest_history`	Latest history	Pro	`{"coin":"BTC"}`
`treasury_summary`	Holdings overview	Pro	`{"coin":"BTC"}`

scripts/features.mjs — Features & Signals

Action	Description	Min Tier	Params
`pair_ticker`	Pair ticker	Free	`{"key_list":"btcusdt:okex,btcusdt:huobipro"}`
`ls_ratio`	Long/short ratio	Basic	None
`nav`	Market navigation	Basic	`{"lan":"cn"}`
`pair_by_market`	Pairs by exchange	Basic	`{"market":"binance"}`
`pair_list`	Pair list	Basic	`{"market":"binance","currency":"USDT"}`
`grayscale_trust`	Grayscale trust	Std	None
`gray_scale`	Grayscale holdings	Std	`{"coins":"btc,eth"}`
`signal_alert`	Signal alerts	Std	None
`signal_config`	Alert config	Std	`{"lan":"cn"}`
`strategy_signal`	Strategy signal	Std	`{"signal_key":"depth_win_one"}`
`change_signal`	Anomaly signal	Std	`{"type":"1"}`
`big_orders`	Whale orders	Std	`{"symbol":"btcswapusdt:binance"}`
`agg_trades`	Aggregated large trades	Std	`{"symbol":"btcswapusdt:binance"}`
`liquidation`	Liquidation data	Adv	`{"type":"1","coinKey":"bitcoin"}`
`signal_alert_list`	Alert list	Pro	None
`stock_market`	Crypto stocks	Pro	None
`delete_signal`	Delete alert	Pro	`{"id":"xxx"}`

scripts/news.mjs — News & Content

Action	Description	Min Tier	Params
`news_rss`	RSS news feed	Free	`{"page":"1"}`
`news_list`	News list	Basic	`{"page":"1","pageSize":"20"}`
`flash_list`	Industry flash news	Basic	`{"language":"cn"}`
`newsflash`	AiCoin flash news	Std	`{"language":"cn"}`
`news_detail`	News detail	Std	`{"id":"xxx"}`
`exchange_listing`	Exchange listing announcements	Pro	`{"memberIds":"477,1509"}`

scripts/twitter.mjs — Twitter/X Crypto Tweets

Action	Description	Min Tier	Params
`latest`	Latest crypto tweets	Basic	`{"language":"cn","page_size":"20"}`
`search`	Search tweets	Basic	`{"keyword":"bitcoin","language":"cn","page_size":"20"}`
`members`	Search KOL/users	Std	`{"word":"elon","page":"1","size":"20"}`
`interaction_stats`	Tweet engagement stats	Std	`{"flash_ids":"123,456,789"}`

scripts/newsflash.mjs — Newsflash (OpenData)

Action	Description	Min Tier	Params
`search`	Search newsflash	Basic	`{"word":"bitcoin","page":"1","size":"20"}`
`list`	Newsflash list with filters	Basic	`{"pagesize":"20","lan":"cn"}`
`detail`	Newsflash full content	Std	`{"flash_id":"123456"}`

Cross-Skill References

Need	Use
Exchange trading (buy/sell/balance)	aicoin-trading
Freqtrade strategies/backtest/deploy	aicoin-freqtrade
Hyperliquid whale tracking	aicoin-hyperliquid

Common Errors

```
errorCode 304 / HTTP 403
```
— Paid feature. Follow Paid Feature Guide below.
```
Invalid symbol
```
— Check format: AiCoin uses
```
btcusdt:okex
```
, not
```
BTC/USDT
```
```
Rate limit exceeded
```
— Wait 1-2s between requests; use batch queries

Paid Feature Guide

When a script returns 304 or 403, this endpoint requires a higher API tier. Do NOT retry the same call.

Tell the user (in their language):

What happened: This feature needs a paid AiCoin API subscription.
How to get a key: Visit https://www.aicoin.com/opendata to register and create an API key.
Tier options:

Tier	Price	Highlights
Free	$0	Prices, K-lines, trending coins (6 endpoints)
Basic	$29/mo	+ Funding rate, L/S ratio, news, twitter (24 endpoints)
Standard	$79/mo	+ Whale orders, signals, grayscale (38 endpoints)
Advanced	$299/mo	+ Liquidation map, indicator K-lines, index, depth (49 endpoints)
Professional	$699/mo	All 63 endpoints: AI analysis, OI, stocks, treasury

How to configure: After getting a key, add to
```
.env
```
file:

AICOIN_ACCESS_KEY_ID=your-key-id
AICOIN_ACCESS_SECRET=your-secret

Scripts auto-load

.env

from cwd,

~/.openclaw/workspace/.env

, or

~/.openclaw/.env

After configuring: The same script command will work. No code changes needed.

aicoin-market

NPX Install

SKILL.md Content