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:
curl http://localhost:8000/ || (cd ~/.openclaw/workspace/skills/yfinance && uvicorn main:app --host 0.0.0.0 --port 8000 --reload &)
pip install -r requirements.txt
Verify it is up:
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 form | Resolved ticker | Company |
|---|---|---|
| BBCA | BBCA.JK | Bank Central Asia |
| TLKM | TLKM.JK | Telkom Indonesia |
| BBRI | BBRI.JK | Bank Rakyat Indonesia |
| GOTO | GOTO.JK | GoTo Group |
| ASII | ASII.JK | Astra 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
curl "http://localhost:8000/price?ticker=BBCA"
2. Historical OHLCV Data
curl "http://localhost:8000/history?ticker=BBCA&period=1y&interval=1d"
3. Company Fundamentals
curl "http://localhost:8000/fundamentals?ticker=BBRI"
4. Dividend History
curl "http://localhost:8000/dividends?ticker=ASII"
5. Stock Split History
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.