aicoin-market_skill

Overview

This skill provides real-time crypto market data and analytics powered by AiCoin Open API. It covers prices, K-line charts, funding rates, open interest, long/short ratios, whale orders, liquidation data, news, Twitter/X crypto tweets, trending coins, and stock/treasury quotes across 200+ exchanges. Always run the included node scripts to fetch live data; never fabricate prices or market figures.

How this skill works

The skill invokes specific node scripts (scripts/*.mjs) to query AiCoin Open API endpoints and return live market data. Free endpoints work with the built-in free key; paid endpoints return 304/403 and require a paid AiCoin API key configured in a .env file. The scripts auto-load .env from the working directory or standard workspace locations.

When to use it

• Ask for real-time prices: “BTC price”, “check price”, or multi-coin tickers
• Request K-line / candlestick charts or indicator-enhanced K-lines
• Query funding rates, open interest, long/short ratios, or liquidation maps
• Investigate whale orders, large trades, or orderbook depth (paid endpoints)
• Fetch crypto news, newsflash, Twitter/X crypto tweets, or trending coins
• Request stock quotes, treasury holdings, or other paid market datasets

Best practices

• Always run the provided node scripts to retrieve live data — never guess or synthesize prices
• Use symbol formats required by AiCoin (e.g., btcusdt:okex) to avoid Invalid symbol errors
• If a script returns 304 or 403, stop and follow the Paid Feature Guide instead of retrying
• Keep API credentials in .env and never print environment variables or share secrets
• Batch requests when possible to reduce rate-limit issues and add short delays between calls

Example use cases

• Get current BTC and ETH prices: run node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin,ethereum"}'
• Show 1-hour K-line for BTC/USDT on OKEx: node scripts/market.mjs kline '{"symbol":"btcusdt:okex","period":"3600","size":"100"}'
• Check funding rate or long/short ratio before placing leverage trades
• Investigate recent whale orders or liquidation heatmap to assess market stress (paid)
• Fetch the latest crypto newsflash or search recent Twitter/X posts about a coin