coinank-openapi

What This Skill Does

The coinank-openapi skill is a specialized OpenClaw agent tool designed to interface directly with the Coinank Open API. It empowers users to fetch high-fidelity cryptocurrency market data, including derivatives information, liquidation data, and open interest statistics, directly within their workflow. By utilizing OpenAPI specifications, the agent can dynamically parse endpoints and map user requests to precise API calls, ensuring high accuracy and data integrity for professional crypto analysis. It automates the retrieval process by handling authentication, URL construction, and intelligent timestamp generation for time-sensitive queries.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/annata/coinank-openapi

Once installed, ensure you have your Coinank API key ready. You must set this in your environment variables to authorize the agent: export COINANK_API_KEY="your_api_key". Without this environment variable, the skill will be unable to complete network requests to the provider.

Use Cases

• Derivative Analysis: Query real-time liquidation data across major exchanges to assess market volatility and potential cascade events.
• Open Interest Tracking: Monitor open interest shifts to identify major institutional position movements or market sentiment changes.
• Quantitative Research: Automatically fetch historical datasets based on specific time intervals to power backtesting or trend analysis models.
• Automated Alerts: Integrate with other agents to receive notifications when specific crypto market metrics exceed defined thresholds.

Example Prompts

1. "Check the current open interest for BTC on Binance using the coinank-openapi tool and compare it with the data from three hours ago."
2. "Get the latest liquidation statistics for ETH/USDT across all available exchanges to analyze the market sentiment."
3. "Fetch the top 10 most liquidated symbols in the last 24 hours and summarize the impact on market direction."

Tips & Limitations

• Time Precision: Always rely on the agent's internal timestamp generator for endTime parameters. Manually typing dates can lead to errors; if you need a specific range, just specify the timeframe in plain language.
• API Key Security: Never hardcode your COINANK_API_KEY directly into your scripts or configuration files. Always use secure environment variables.
• Rate Limiting: Be mindful that Coinank enforces rate limits on their OpenAPI. Do not configure agents to poll endpoints excessively to avoid service suspension.
• Scope Management: The skill is designed to only read relevant .json reference files from {baseDir}/references/. Ensure your reference folder is correctly populated for the endpoints you intend to use.