overlay-market

What This Skill Does

The overlay-market skill enables your OpenClaw AI agent to interact with the Overlay Protocol on the BNB Smart Chain (BSC). It facilitates the trading of synthetic, leveraged perpetual futures across a diverse range of assets, including cryptocurrencies, commodities, and social metrics. Unlike traditional order-book exchanges, Overlay operates on a unique protocol-managed price feed system. The skill manages the entire lifecycle of a position: scanning available markets, analyzing price action through technical indicators, checking current collateral balances, constructing transaction payloads for opening or closing (unwinding) positions, and monitoring ongoing trade performance and PnL.

Installation

To integrate this skill into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/arthurka-o/overlay-market

Ensure your agent environment is configured with the necessary BSC RPC endpoints and, if required for 1inch swap routing, an optional API key. It is highly recommended to use a smart contract wallet (like Safe) with restricted permissions to limit the agent's signing authority.

Use Cases

• Market Analysis: Automatically monitor price volatility and identify potential entry points using integrated OHLC data.
• Automated Trading: Execute complex long or short positions based on predefined risk parameters or technical triggers.
• Portfolio Management: Regularly query current PnL for active positions and handle systematic unwinding of positions when profit targets or stop-loss levels are reached.
• Synthetic Exposure: Gain leverage on non-crypto assets (indices, commodities) directly from your agent interface.

Example Prompts

1. "Scan the Overlay market for the most volatile assets in the last 24 hours and report back with their current price trends."
2. "Check the status of my current positions on Overlay; if any have reached a 10% gain, prepare an unwind transaction for me to review."
3. "Open a 5x short position on BTC-USD with 100 USDT collateral and provide the transaction object for my approval."

Tips & Limitations

• Safety First: Never provide raw private keys to the agent. Always prefer external signing mechanisms or multi-sig wallets to protect your funds.
• 1inch Routing: The skill uses 1inch for unwinding. If you encounter issues, verify your ONEINCH_API_KEY configuration. The protocol requires strict validation of swap parameters; ensure your environment can handle precise ABI encoding/decoding.
• Network Dependence: This skill requires constant access to the Goldsky subgraph and Overlay's market APIs. Ensure your agent's internet connection and RPC stability are robust for real-time trading.
• Static Analysis: Note that common.js may trigger false positive warnings in some security scanners; these are documented by the author and are safe in this context.