FollowinOpenAPI

Documents Followin OpenAPI endpoints for agent integration. Use when calling feed APIs, channel feeds, trending, category feeds, or integrating with Followin...

Security Scan

This skill is an instruction-only reference for the Followin OpenAPI and its curl examples; its requirements and instructions match the stated purpose and nothing appears disproportionate.

Purpose & Capability

Name and description state it documents Followin OpenAPI endpoints; the SKILL.md contains only endpoint docs, parameters, responses, and curl examples. Requiring curl and providing a brew install for curl is coherent with the stated purpose (curl examples). No unrelated binaries, env vars, or credentials are requested.

Instruction Scope

The runtime instructions are limited to API documentation and example requests to https://api.followin.io. They do not direct the agent to read local files, environment variables, other services, or transmit data to unexpected endpoints. The examples explicitly show passing an API key via query or Authorization header, which aligns with the documented authentication method.

Install Mechanism

Install spec only offers a brew formula for curl. This is reasonable, but installing curl via brew may be redundant on many systems (curl is commonly present). The install source (Homebrew) is a standard package manager; no arbitrary downloads or archive extraction are used.

Credentials

The skill declares no required environment variables or credentials. The documentation references an API key as required by the Followin API, which is appropriate and limited in scope. No unrelated secrets or config paths are requested.

Persistence & Privilege

always is false and the skill does not request persistent system or agent-wide privileges. There are no instructions to modify other skills or system-wide configuration.

Assessment

This skill is a documentation helper and appears coherent. Before installing, verify you intend to call api.followin.io and that the service is legitimate. If you obtain an API key to use with Followin, prefer sending it in an Authorization header rather than as a query parameter (query parameters can be logged or leaked via referer headers). Installing curl via Homebrew is harmless on most systems but may be unnecessary if curl is already present. As always, never share your API keys publicly and confirm TLS (https) is used when calling the API.

Agent 调用 Followin 信息流接口时使用本 skill。

说明：「频道」也称为「情报」或「情报中心」。

Base URL

https://api.followin.io

鉴权

所有 OpenAPI 请求需携带 API Key，支持两种方式：

方式	示例
Query 参数	?apikey=YOUR_API_KEY
Header	Authorization: YOUR_API_KEY

支持的语言

以下接口的 lang 参数支持以下语言代码：

代码	说明
zh-Hans	简体中文
zh-Hant	繁体中文
en	英语
vi	越南语
ko	韩语

接口列表

1. 热榜

获取今日热榜 feed 列表。

请求
GET /open/feed/list/trending

参数	必填	说明
type	否	类型：hot_news（默认）、pop_info
count	否	数量，默认 15
need_bind_tag	否	是否仅返回有标签的，默认 false
lang	否	语言：zh-Hans、zh-Hant、en、vi、ko

响应

{
  "list": [ { "id", "title", "content", "publish_time", "page_url", "related_feeds", ... } ],
  "update_time": 1234567890
}

2. 分类推荐

按分类获取推荐 feed 列表。

请求
GET /open/feed/:category_name

路径参数	说明
category_name	分类名：news（快讯）、articles（文章）

Query 参数	必填	说明
count	否	每页数量，默认 10，最大 30
last_cursor	否	分页游标（时间戳），默认 0
only_important	否	仅重要快讯（news 有效），默认 false
no_ad	否	不展示广告，默认 false
lang	否	语言：zh-Hans、zh-Hant、en、vi、ko

响应

{
  "list": [ { "id", "title", "content", "publish_time", "page_url", ... } ],
  "has_more": true,
  "last_cursor": "1234567890",
  "last_source": "biz",
  "rec_request_id": ""
}

3. 指定频道信息流

获取单个频道（情报/情报中心）的信息流。

请求
GET /open/channel/feeds

参数	必填	说明
code	是	频道 code
count	否	每页数量，默认 20，最大 30
last_cursor	否	分页游标，默认 0
lang	否	语言：zh-Hans、zh-Hant、en、vi、ko

支持的频道 code

• macro - 宏观
• listing_delisting - 上币/下币
• altcoin_update - 山寨币更新
• quant_signal - 量化信号
• live_trading_signal - 实盘信号
• token_unlock - 代币解锁
• fund_movement - 资金异动
• all_potential_airdrop - 空投教程
• airdrop_issue - 领取通知
• kol_post - KOL 动态
• trading_signal - 点位喊单
• trading_strategy - 交易策略
• meme_discover - 发现 meme
• meme_opportunity - meme 交易机会
• alpha_aggregator - Alpha 聚合器
• exchange_coin_update - 交易所上币动态

响应

{
  "list": [ { "id", "title", "content", "publish_time", "page_url", ... } ],
  "has_more": true,
  "last_cursor": "20"
}

4. 所有频道 feed_card 信息流

获取支持 feed_card 的频道（情报/情报中心）混合信息流（含卡片）。

请求
GET /open/channel/feeds/card

参数	必填	说明
count	否	每页数量，默认 20，最大 30
last_cursor	否	分页游标，默认 0
lang	否	语言：zh-Hans、zh-Hant、en、vi、ko

响应

{
  "list": [
    {
      "id": 123,
      "title": "...",
      "content": "...",
      "publish_time": 1234567890,
      "page_url": "https://...",
      "feed_card": {
        "card_type": "f1_news",
        "fields": [ { "key", "value", "key_text", "value_text" } ],
        "show_feed": true
      }
    }
  ],
  "has_more": true,
  "last_cursor": "20"
}

分页

• 首次请求：last_cursor=0 或不传
• 后续请求：使用上一页返回的 last_cursor
• has_more=false 表示无更多数据

curl 示例

# 1. 热榜
curl -X GET "https://api.followin.io/open/feed/list/trending?type=hot_news&count=15&lang=en&apikey=YOUR_API_KEY"

# 2. 分类推荐（快讯 / 文章）
curl -X GET "https://api.followin.io/open/feed/news?count=20&lang=en&apikey=YOUR_API_KEY"
curl -X GET "https://api.followin.io/open/feed/articles?count=20&last_cursor=0&lang=zh-Hans" \
  -H "Authorization: YOUR_API_KEY"

# 3. 指定频道（macro）
curl -X GET "https://api.followin.io/open/channel/feeds?code=macro&count=20&last_cursor=0&lang=en&apikey=YOUR_API_KEY"

# 4. 所有频道 feed_card
curl -X GET "https://api.followin.io/open/channel/feeds/card?count=20&last_cursor=0&lang=en&apikey=YOUR_API_KEY"

# 5. 分页（使用上一页返回的 last_cursor）
curl -X GET "https://api.followin.io/open/channel/feeds/card?count=20&last_cursor=20&lang=zh-Hans" \
  -H "Authorization: YOUR_API_KEY"