yfinance（yfinance 效率）

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.

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.