Fetch Complete Convertible Bond Lists with cb-lists

Where this fits

A user asks: "What convertible bonds are available right now?" Your agent needs a complete, current list of CB codes, names, and linked stocks. Without a dedicated skill, you'd scrape exchange sites or maintain fragile parsers. The cb-lists skill from FTShare-Lab gives agents a direct, parameter-free API call to fetch the full convertible bond universe, making this common request a one-liner.

Why agents benefit

• Instant full dataset: Returns all CBs (bond code, full name, underlying stock code, exchange) in a single GET request—no pagination or filtering needed.
• Zero configuration: No API keys, headers, or request bodies. Agents can call it immediately after installation.
• Structured output: JSON response with typed fields (full_name, cb_id, stock_id, exchange) that maps cleanly to agent memory or downstream tools.
• Exchange clarity: The exchange field (e.g., 1 for Shanghai) lets agents disambiguate between markets without extra lookups.
• Freshness built-in: Data is from the previous trading day, so agents can trust it for daily routines without manual refresh logic.

Practical scenarios

Portfolio Screening

An agent scans all CBs to filter those with a specific underlying stock code or exchange, helping a user shortlist bonds for further analysis.

Market Overview Generation

When a user asks "What's the CB market like today?", the agent fetches the list, counts bonds per exchange, and summarizes the landscape—no extra API calls.

Automated Reporting

A daily cron-triggered agent pulls the CB list and cross-references it with price data (from other skills) to generate a morning briefing for a trading desk.

Add it to your agent workflow

Install the skill with:

npx skills add FTShare-Lab/FTShare-skill --skill cb-lists

Then invoke it from your agent's main script (assuming run.py is in the skill directory):

python /path/to/run.py cb-lists

The output is a JSON array under items. For example:

{
  "items": [
    {"full_name": "恒逸石化股份有限公司可转换公司债券", "cb_id": 110070, "stock_id": 703, "exchange": 1}
  ]
}

No extra headers or parameters are required.

Compare before adopting

Before wiring this in, evaluate: Quality signals—check the GitHub repo's star count (currently 58) and recent commits to see if the underlying API is actively maintained. Maintenance freshness—the data source is market.ft.tech; verify it stays current. Alternatives—consider whether your broker or data vendor offers a similar endpoint with richer fields (e.g., conversion price). Workflow fit—if your agent already has a CB data pipeline, this skill may be redundant; otherwise, it's a low-friction drop-in.

Why it is worth tracking

This skill is part of the FTShare-Lab ecosystem, which focuses on market data skills for agents. With 58 stars and a simple, dependency-free design, it's a good candidate for agents that need reliable CB lists without heavy integration. Track it if you're building financial agents that handle bond screening or market analysis—its simplicity and zero-auth setup make it a pragmatic choice. For more skills in this category, see the OpenAgentSkill directory at https://www.openagentskill.com/skills/ftshare-lab-cb-lists.