API DOCS · v1

新鮮勢 Web3 Attention API

目前資料量：448 個事件 · 309 個 top-level · 86 個 tag · 4 個月份

Endpoints

範例

curl

# 拿今天的 daily brief
curl https://feeds.blocktrend.today/v1/attention/daily.json | jq

# 抓單一事件詳細
curl https://feeds.blocktrend.today/v1/events/2026-05-28-samsung-trio-dunamu-upbit-4pct-korea-stablecoin.json

# 拿 2026 年 5 月所有事件
curl https://feeds.blocktrend.today/v1/months/2026-05.json

# 先看目錄知道有哪些 tag / 月份
curl https://feeds.blocktrend.today/v1/taxonomy.json | jq '.tags[] | select(.count > 5)'

JavaScript / fetch

const res = await fetch('https://feeds.blocktrend.today/v1/attention/daily.json');
const { events } = await res.json();
for (const e of events) {
  console.log(e.date, e.title, '/', e.permalink);
}

Python

import httpx

r = httpx.get('https://feeds.blocktrend.today/v1/attention/daily.json')
for e in r.json()['events']:
    print(f"{e['date']}  [{e['display_score']}]  {e['title']}")

事件 schema

List 型 endpoint（events / attention/daily / updates / tags / months）都回 { generated_at, count, events: [...] }。 單一事件 endpoint（/v1/events/{id}.json）回 { generated_at, event: {...}, children: [...] }， 兩者的 event 物件結構相同。欄位如下：

DiscussionMetadata 子物件

Source 子物件

ContextLink 子物件

版本與穩定性承諾

• v1 不會改現有欄位名稱、不會刪欄位。可能新增欄位（non-breaking）。
• 未來會新增的欄位包含 attention_score、why_ranked、confidence_score、source_quality_score。Consumer 對這些「還沒有的欄位」要 defensive。
• 未列入這份文件的欄位都視為 internal、可能隨時改名或消失，請不要依賴。特別包含：以 _ 開頭的任何欄位、fetchedFrom、cluster_split_*、chart。
• Breaking change 會升 v2，v1 端點保留至少 6 個月。
• 資料更新頻率：autofarm 每 6 小時掃一次，重大事件會手動 trigger 更新。

注記

• /v1/attention/daily.json 目前 cap 30 件、/v1/updates.json 目前 cap 50 件。實際數字可能調整，不視為穩定承諾。請以 response 的 count 欄位為準。
• 所有 list endpoint 都不分頁。如未來資料量讓全量回應變大，會新增 cursor-based pagination 並保留現有 endpoint 的非分頁行為。
• 單一事件 endpoint 的 children 僅在 top-level 事件有值。sub-event 的 children 永遠是 []。

授權

v1 公開測試。歡迎讀取與引用，請在 consumer 端附上：

• 來源標示：「資料來源：新鮮勢」
• 連結回 permalink 欄位的 URL，或回首頁 https://feeds.blocktrend.today

轉售、再散布整份 feed、用於閉源模型訓練，請先聯絡 mingnhsu@gmail.com 另行同意。商業條件目前還在規劃中。

回饋

用了覺得哪裡卡、想要哪個 endpoint 沒有，歡迎來信 mingnhsu@gmail.com 或在 X 上 @mnhsuTW。第一批 pilot 使用者的回饋會 直接形塑 v2 的設計。