Crypto & Stock Market Data (Node.js)

--- name: Crypto & Stock Market Data (Node.js) description: No API KEY needed for free tier. Professional-grade cryptocurrency and stock market data integration for real-time prices, company profiles, and global analytics. Powered by Node.js with zero external dependencies. --- # Crypto & Stock Market Data Skill (Node.js) A comprehensive suite of tools for retrieving real-time and historical cryptocurrency and stock market data. This skill interfaces with a dedicated market data server to provide high-performance, authenticated access to global financial statistics. Built entirely on Node.js standard libraries — no `npm install` required. ## Key Capabilities | Category | Description | | :--- | :--- | | **Real-time Prices** | Fetch current valuations, market caps, 24h volumes, and price changes for crypto & stocks. | | **Market Discovery** | Track trending assets and top-performing coins by market capitalization. | | **Smart Search** | Quickly find coin IDs or stock tickers by searching names or symbols. | | **Deep Details** | Access exhaustive asset information, from community links to company profiles. | | **Precise Charts** | Retrieve OHLC candlestick data and historical price/volume time-series. | | **Global Metrics** | Monitor total market capitalization and public company treasury holdings. | ## Tool Reference | Script Name | Primary Function | Command Example | | :--- | :--- | :--- | | `get_crypto_price.js` | Multi-coin price fetch | `node scripts/get_crypto_price.js bitcoin` | | `get_stock_quote.js` | Real-time stock quotes | `node scripts/get_stock_quote.js AAPL MSFT` | | `get_company_profile.js` | Company overview | `node scripts/get_company_profile.js AAPL` | | `search_stocks.js` | Find stock tickers | `node scripts/search_stocks.js apple` | | `get_trending_coins.js` | 24h trending assets | `node scripts/get_trending_coins.js` | | `get_top_coins.js` | Market leaderboards | `node scripts/get_top_coins.js --per_page=20` | | `search_coins.js` | Asset discovery | `node scripts/search_coins.js solana` | | `get_coin_details.js` | Comprehensive metadata | `node scripts/get_coin_details.js ethereum` | | `get_coin_ohlc_chart.js` | Candlestick data | `node scripts/get_coin_ohlc_chart.js bitcoin` | | `get_coin_historical_chart.js` | Time-series data | `node scripts/get_coin_historical_chart.js bitcoin` | | `get_global_market_data.js` | Macro market stats | `node scripts/get_global_market_data.js` | | `get_public_companies_holdings.js` | Treasury holdings | `node scripts/get_public_companies_holdings.js bitcoin` | | `get_supported_currencies.js` | Valuation options | `node scripts/get_supported_currencies.js` | --- ## Usage Details ### 1. `get_crypto_price.js` Fetch real-time pricing and basic market metrics for one or more cryptocurrencies. **Syntax:** ```bash node scripts/get_crypto_price.js [coin_id_2] ... [--currency=usd] ``` **Parameters:** - `coin_id`: The unique identifier for the coin (e.g., `bitcoin`, `solana`). - `--currency`: The target currency for valuation (default: `usd`). **Example:** ```bash node scripts/get_crypto_price.js bitcoin ethereum cardano --currency=jpy ``` --- ### 2. `get_top_coins.js` Retrieve a list of the top cryptocurrencies ranked by market capitalization. **Syntax:** ```bash node scripts/get_top_coins.js [--currency=usd] [--per_page=10] [--page=1] [--order=market_cap_desc] ``` **Parameters:** - `--currency`: Valuation currency (default: `usd`). - `--per_page`: Number of results (1-250, default: `10`). - `--order`: Sorting logic (e.g., `market_cap_desc`, `volume_desc`). --- ### 3. `get_coin_ohlc_chart.js` Get Open, High, Low, Close (candlestick) data for technical analysis. **Syntax:** ```bash node scripts/get_coin_ohlc_chart.js [--currency=usd] [--days=7] ``` **Allowed `days` values:** `1, 7, 14, 30, 90, 180, 365`. | Range | Resolution | | :--- | :--- | | 1-2 Days | 30 Minute intervals | | 3-30 Days | 4 Hour intervals | | 31+ Days | 4 Day intervals | --- ### 4. `get_coin_historical_chart.js` Retrieve detailed historical time-series data for price, market cap, and volume. **Syntax:** ```bash node scripts/get_coin_historical_chart.js [--currency=usd] [--days=30] ``` --- ### 5. `get_stock_quote.js` Fetch real-time stock prices for one or more ticker symbols. **Syntax:** ```bash node scripts/get_stock_quote.js [SYMBOL_2] ... ``` --- ### 6. `get_company_profile.js` Get a comprehensive company profile, including description, industry, and CEO. **Syntax:** ```bash node scripts/get_company_profile.js ``` --- ## Important Guidelines ### Cryptos: Use IDs | Stocks: Use Tickers - **Cryptocurrencies**: Always use **Coin IDs** (slugs) instead of ticker symbols (e.g., `bitcoin`, `BTC`). - **Stocks**: Always use **Ticker Symbols** (e.g., `AAPL`, `Apple`). Use `search_coins.js` if you are unsure of the correct ID. ### Authentication Authentication is handled **automatically** by the internal `api_client.js`. Here is how it works simply: - **Endpoint**: `GET https://api.igent.net/api/token` - **Mechanism**: 1. **Automatic Retrieval**: The first time you use a tool, it asks the server for a temporary session token. 2. **Local Storage**: This token is stored in a hidden `.token` file locally so it can be reused for subsequent requests. 3. **Automatic Headers**: The client automatically includes this token in every request to prove you are authorized. 4. **Auto-Refresh**: If a token expires, the client automatically fetches a new one without you needing to do anything. No manual API keys or configuration are required. ### Rate Limiting While the system is robust, please avoid burst requests (more than 30 per minute) to maintain service stability for all users. ### Agent Integration This skill is fully compatible with OpenClaw and other agents using the **AgentSkills** standard. Execute scripts directly from the `scripts/` directory.