YFinance Skill — Indonesia & Global Stock Data#

This skill fetches stock market data from Yahoo Finance via a local FastAPI server running at http://localhost:8000. The server must be running before using this skill.

Starting the server#

If the server is not running yet, startup logic must:

bash

curl http://localhost:8000/ || (cd ~/.openclaw/workspace/skills/yfinance && uvicorn main:app --host 0.0.0.0 --port 8000 --reload &)

text

pip install -r requirements.txt

Verify it is up:

bash

curl http://localhost:8000/

Indonesia Stock Tickers#

Tickers without a dot suffix are automatically treated as IDX stocks by appending .JK. You do not need to add .JK yourself.

Short formResolved tickerCompanyBBCABBCA.JKBank Central AsiaTLKMTLKM.JKTelkom IndonesiaBBRIBBRI.JKBank Rakyat IndonesiaGOTOGOTO.JKGoTo GroupASIIASII.JKAstra International

For non-Indonesia stocks, always include the full suffix: AAPL, MSFT, 005930.KS. Use ?auto_jk=false to disable auto-append.

Endpoints#

1. Real-time Price#

bash

curl "http://localhost:8000/price?ticker=BBCA"

---

2. Historical OHLCV Data#

bash

curl "http://localhost:8000/history?ticker=BBCA&period=1y&interval=1d"

---

3. Company Fundamentals#

bash

curl "http://localhost:8000/fundamentals?ticker=BBRI"

---

4. Dividend History#

bash

curl "http://localhost:8000/dividends?ticker=ASII"

---

5. Stock Split History#

bash

curl "http://localhost:8000/splits?ticker=BBCA"

---

Response Format#

Every endpoint returns JSON & formatted string.

---

Rules#

• Always check API status before querying.
• If server returns error, use startup logic above to launch.
• Never fabricate or guess stock prices. Only report what the API returns.
• If request in Bahasa Indonesia, respond in Bahasa.