idx-market-data

What This Skill Does

The idx-market-data skill is a specialized integration for the OpenClaw AI agent, enabling it to bridge the gap between users and real-time financial market data from the Indonesia Stock Exchange (IDX). By leveraging the GoAPI infrastructure, this skill allows the agent to fetch, process, and present live stock prices, market trends, historical data, and index performance (IHSG) directly within the chat interface. It acts as a financial analyst assistant, removing the need for users to manually browse brokerage apps to find basic ticker information or performance updates. The skill handles the complexity of API communication, ensuring that data is parsed from JSON into human-readable formats like lists and tables.

Installation

To integrate this skill into your OpenClaw environment, ensure you have the OpenClaw CLI installed. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/angween/idx-market-data

After installation, you must configure your credentials. Obtain a valid API Key from GoAPI.io and set it as an environment variable named GOAPI_KEY. The skill is designed to securely pass this key via query parameters as per the provider's authentication requirements. Once set, restart your OpenClaw instance to apply the configuration.

Use Cases

This skill is ideal for retail investors, financial students, and professionals who need rapid information retrieval. Common use cases include:

• Market Monitoring: Quickly checking the performance of the Jakarta Composite Index (IHSG) before making trades.
• Trend Analysis: Identifying high-volume stocks that are currently trending on the exchange.
• Data Retrieval: Extracting historical pricing for specific symbols like BBCA or ASII to conduct personal technical analysis.
• Research: Looking up company tickers when the user only knows the company name, streamlining the investigative process.

Example Prompts

• "Berapa harga saham BBCA saat ini dan apakah sedang mengalami kenaikan?"
• "Tampilkan daftar saham yang sedang paling aktif diperdagangkan (trending) di IDX hari ini."
• "Tarik data historis harga saham ASII untuk periode 1 Oktober 2023 sampai 7 Oktober 2023."

Tips & Limitations

• Efficiency: Always rely on the /trending endpoint for the most up-to-date prices rather than historical data endpoints.
• Accuracy: Ensure your environment variables are correctly exported; invalid keys will result in immediate authentication failures reported by the API.
• Rate Limits: Be mindful of your GoAPI plan's rate limits. Excessive requests in a short duration may cause the skill to stop returning data until the quota resets.
• Scope: This skill is strictly for the Indonesia Stock Exchange (IDX); it cannot fetch data for foreign markets like the NYSE or NASDAQ.