Skip to content

feat(xueqiu): add earnings-date command#211

Merged
jackwener merged 1 commit intojackwener:mainfrom
platoneko:earnings-date
Mar 21, 2026
Merged

feat(xueqiu): add earnings-date command#211
jackwener merged 1 commit intojackwener:mainfrom
platoneko:earnings-date

Conversation

@platoneko
Copy link
Copy Markdown
Contributor

Summary

Add new YAML adapter xueqiu/earnings-date to fetch upcoming earnings report dates from xueqiu company events API (/v5/stock/screener/event/list.json).

Supports A-share (e.g. SH600519) and H-share (e.g. 00700) stocks.

Usage

# List all earnings dates (A-share)
opencli xueqiu earnings-date --symbol SH600519

# List all earnings dates (H-share)
opencli xueqiu earnings-date --symbol 00700

# Show only the next upcoming (unreleased) earnings date
opencli xueqiu earnings-date --symbol 01810 --next

# JSON output
opencli xueqiu earnings-date --symbol SH600519 -f json

# Limit results
opencli xueqiu earnings-date --symbol SZ000858 --limit 5

Example Output

┌────────────┬────────────────────┬───────────┐
│ Date       │ Report             │ Status    │
├────────────┼────────────────────┼───────────┤
│ 2026-03-23 │ 发布2025财年四季报 │ ⏳ 未发布 │
├────────────┼────────────────────┼───────────┤
│ 2025-11-17 │ 发布2025财年三季报 │ ✅ 已发布 │
└────────────┴────────────────────┴───────────┘

Arguments

Arg Type Default Description
--symbol str (required) Stock symbol (e.g. SH600519, SZ000858, 00700)
--next bool false Only return the closest upcoming unreleased earni?s date
--limit int 10 Max number of results

Implementation Details

  • Queries xueqiu company events API and filters by subtype === 2 (scheduled earnings release)
  • Displays ⏳/✅ status based on whether the report date is in the future or past
  • --next flag sorts future events by date and returns only the nearest one

Add new YAML adapter to fetch upcoming earnings dates from xueqiu's
company events API (公司大事). Supports A-share and H-share stocks.

Features:
- Filter by subtype=2 (预计财报发布) from event timeline
- Show date, report name, and release status (⏳/✅)
- --next flag to return only the closest upcoming earnings date
- --limit to control result count
@jackwener jackwener merged commit fae1dce into jackwener:main Mar 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants