erwa-api

Erwa Aggregation Group API

Aggregates 38+ Feishu groups, providing Web3 data services for group chat AI summaries, CA contract tracking, KOL opinions, and market news flashes.

---

Installation

npx skills add hengxuZ/erwaAPI

---

Authentication

All endpoints use Bearer Token authentication:

Authorization: Bearer <your-token>

To get a Token: contact the administrator on WeChat erwaNFT

Base URL: https://juhequn.com

---

API Overview

Module	Endpoint	Method	Description
CA Tracking	/api/v1/group_ca	GET	CA list (supports multi-dimensional filtering)
CA Tracking	/api/v1/group_ca/popular	GET	Trending CA statistics
CA Tracking	/api/v1/group_ca/latest	GET	Latest CA records
CA Tracking	/api/v1/group_ca/sync	GET	Incremental CA sync by ID
CA Tracking	/api/v1/group_ca/by-username/{username}	GET	Query CA by username
CA Tracking	/api/v1/group_ca/query_group	GET	Query group source by CA
CA Tracking	/api/v1/group_ca/user_content	GET	Query group members' discussion status
CA Tracking	/api/v1/group_ca/by-ca/{ca_address}	GET	Query group source by CA address
CA Tracking	/api/v1/group_ca/search	GET	Global search, parameter q
CA Tracking	/api/v1/group_ca/info/{ca_address}	GET	CA aggregated metadata and summary
CA Tracking	/api/v1/group_ca/{ca_id}	GET	Query CA by database ID
CA Tracking	/api/v1/group_ca/http	GET	CA-related HTTP records
CA Tracking	/api/v1/group_ca/board/summary	GET	CA dashboard summary
CA Tracking	/api/v1/group_ca/board/ca/{ca_address}	GET	Single CA dashboard details
CA Tracking	/api/v1/group_ca/board/ca/{ca_address}/kline	GET	Single CA K-line
CA Tracking	/api/v1/group_ca/call-leaderboard	GET	Call success leaderboard
Link Tracking	/api/v1/group_http	GET	HTTP link list
Link Tracking	/api/v1/popular_http	GET	Trending HTTP statistics
Group Chat Summary	/api/v1/summaries/groups	GET	Available group names
X Tweets	/api/v1/popular_tweets/latest	GET	Latest trending tweets
X Tweets	/api/v1/popular_tweets/previews	GET	CA/URL/X account tweet preview
X Tweets	/api/v1/popular_x_mention	GET	X account mention leaderboard
Group Chat Summary	/api/v1/summaries	GET	AI group chat summary
Group Chat Summary	/api/v1/summaries/narratives	GET	Daily trending narratives
KOL Opinions	/api/v1/second_kol	GET	Secondary KOL output data
KOL Opinions	/api/v1/second_kol/latest	GET	Latest KOL data
KOL Opinions	/api/v1/second_kol/kol/{kol_name}	GET	Specified KOL data
KOL Opinions	/api/v1/second_kol/kol_names	GET	KOL name list
KOL Opinions	/api/v1/us_stock_kol	GET	US stock KOL output data
KOL Opinions	/api/v1/us_stock_kol/latest	GET	Latest US stock KOL data
KOL Opinions	/api/v1/us_stock_kol/kol/{kol_name}	GET	Specified US stock KOL data
KOL Opinions	/api/v1/us_stock_kol/kol_names	GET	US stock KOL name list
US Stock Dashboard	/api/v1/us_stock_kol/board/summary	GET	US stock ticker summary
US Stock Dashboard	/api/v1/us_stock_kol/board/token/{token_symbol}	GET	Single US stock ticker details
US Stock Dashboard	/api/v1/us_stock_kol/board/token/{token_symbol}/price-line	GET	US stock price line
US Stock Dashboard	/api/v1/us_stock_kol/board/token/{token_symbol}/kline	GET	US stock K-line
News Flash	/api/v1/newsflash/today	GET	Today's News
News	/api/v1/newsflash/date/{date}	GET	News for Specified Date
News	/api/v1/newsflash/latest	GET	Latest News
System	/api/v1/token/usage	GET	Token Usage Count
Group Owner Messages	/api/v1/group_owner_messages/owners	GET	Group Owner Filter List
Group Owner Messages	/api/v1/group_owner_messages/latest	GET	Group Owner Message History
Group Owner Messages	/api/v1/group_owner_messages/sync	GET	Incremental Sync of Group Owner Messages by ID
TG Call	/api/v1/tg_call/latest	GET	TG Call History
TG Call	/api/v1/tg_call/channels	GET	TG Call Channel List
TG News	/api/v1/tg_newsflash/latest	GET	TG News History
TG News	/api/v1/tg_newsflash/sources	GET	TG News Sources
Market	/api/v1/market/prices	GET	BTC/SOL/ETH/BNB/HYPE Market Quotes
Market	/api/v1/market/ca-quotes	POST	Batch CA Market Cap (Supports sui）
Extended Streams	/api/v1/gmgn/hot-searches	GET	GMGN Trending
Extended Streams	/api/v1/gmgn_trenches/completed	GET	Launched MEME
Extended Streams	/api/v1/gmgn/callout/{ca}	GET	Specified CA GMGN Calls
Extended Streams	/api/v1/gmgn_callouts/latest	GET	GMGN Call History
Extended Streams	/api/v1/wind_callouts/latest	GET	FOMO/pump Calls
Extended Streams	/api/v1/purealpha/status	GET	PureAlpha Status
Extended Streams	/api/v1/purealpha/accounts	GET	PureAlpha Accounts
Extended Streams	/api/v1/purealpha/accounts/{source_id}	GET	PureAlpha Single Account
Extended Streams	/api/v1/purealpha/events	GET	PureAlpha Events
Extended Streams	/api/v1/purealpha/feed	GET	PureAlpha Feed
Extended Streams	/api/v1/purealpha/popular	GET	PureAlpha Hot List
Extended Streams	/api/v1/purealpha/hot	GET	PureAlpha Hot Snapshots
Extended Streams	/api/v1/kol_tracker/{slug}/board	GET	KOL Tracker Dashboard
Extended Streams	/api/v1/kol_tracker/{slug}/ticker/{ticker}/price-line	GET	KOL Tracker Target Price Line
Extended Streams	/api/v1/kol_tracker/{slug}/refresh	POST	Refresh KOL Tracker Data
Binance	/api/v1/binance/address/{address}/info	GET	Wallet Address Token Holdings
Binance	/api/v1/binance/token/search	GET	Search Tokens
Binance	/api/v1/binance/token/{ca}/info	GET	Token Metadata and Market Quotes
Binance	/api/v1/binance/token/{ca}/audit	POST	Token Security Audit
Binance	/api/v1/binance/market/rank/{category}	POST	Market Ranking
Binance	/api/v1/binance/meme/rush	POST	Meme Launch Tracking
Binance	/api/v1/binance/trading/signals	POST	Smart Money Trading Signals
Binance	/api/v1/binance/dexscreener/{ca}	GET	DexScreener On-Chain Data
Binance Web3	/api/v1/binance_web3、/api/v1/binance_web3/、/api/v1/binance_web3/{path}	Multiple	Binance Web3 Proxy Forwarding
Smart Money	/api/v1/smart_money	GET	Smart Money Trading Signals
Binance Square	/api/v1/binance_square/status	GET	Data Scraping Status
Binance Square	/api/v1/binance_square/fetch	POST	Manually Trigger Scraping
Binance Square	/api/v1/binance_square/latest	GET	Latest Square Content
Auxiliary	/api/v1/media/image	GET	Image Proxy, Parameter url
Auxiliary	/api/v1/media/feishu_image	GET	Feishu Image Proxy, Parameter key
Auxiliary	/api/v1/notifications/config	GET	Notification Configuration
Auxiliary	/api/v1/notifications/config	PUT	Update Notification Configuration
Auxiliary	/api/v1/notifications/options	GET	Notification Options
Auxiliary	/api/v1/notifications/history	GET	Notification History
Auxiliary	/api/v1/notifications/channels/test	POST	Test Notification Channels
Auxiliary	/api/v1/translate/zh	POST	Chinese Translation
Telegram	/telegram	POST	Telegram Message Receiving Callback
WebSocket	/ws/new_ca	WS	Global new CA real-time push
WebSocket	/ws/new_http	WS	New HTTP link real-time push
WebSocket	/ws/popular_ca	WS	Popular CA real-time ranking
WebSocket	/ws/group-owner-messages	WS	Group owner message real-time push
WebSocket	/ws/new_tg_call	WS	TG Call real-time push
WebSocket	/ws/tg_newsflash	WS	TG news flash real-time push
WebSocket	/ws/second_kol	WS	Crypto KOL real-time push
WebSocket	/ws/us_stock_kol	WS	US stock KOL real-time push
WebSocket	/ws/binance_square	WS	Binance Square real-time push
WebSocket	/ws/purealpha	WS	PureAlpha real-time push
WebSocket	/ws/gmgn_trenches	WS	Launched MEME real-time push
WebSocket	/ws/gmgn_callouts	WS	GMGN call real-time push
WebSocket	/ws/fomo_callouts	WS	FOMO call real-time push
WebSocket	/ws/pump_callouts	WS	pump.fun real-time push
WebSocket	/ws/new_tweet	WS	X trending tweets real-time push

---

Core API details

1. CA list

Endpoint: GET /api/v1/group_ca

Query Parameters:

• ca (string): CA address fuzzy search
• username (string): Username filter
• group_name (string): Group name filter
• limit (int): Number of results to return, default 100, max 1000
• skip (int): Number of records to skip
• date (date): Filter by date (YYYY-MM-DD)

Response (fields per record):

{
  "id": 78146,
  "ca": "0x6106c7d92308bbe4204667a59f9b570288954444",
  "username": "白菜",
  "group_name": "区块日记群",
  "create_time": "2026-03-13T11:34:24",
  "symbol": "PEPE",
  "chain": "bsc",
  "token_name": "Pepe Token",
  "market_cap": "6.4K",
  "first_market_cap": "2.1K",
  "age": 7,
  "total_mentions": 5,
  "twitter": "https://twitter.com/token123",
  "telegram": "https://t.me/token123",
  "website": "https://token123.io",
  "summary": "这是一个meme代币，社区活跃...",
  "m5_buys": 10,
  "h1_buys": 50,
  "h6_buys": 200,
  "h24_buys": 500,
  "user_content": "这个币看起来不错，可以关注一下",
  "liquidity": "37.5K",
  "volume_24h": "3.9M"
}

Field descriptions:

• symbol: Token symbol
• chain: Chain (bsc/sol/base/eth/sui/tron)
• token_name: Token full name
• market_cap: Current market cap (use K for >=1000, M for >=1000K, B for >=1000M; when DexScreener has no data, null）
• first_market_cap: Market cap when first mentioned
• age: Time from token creation to being mentioned (minutes)
• total_mentions: Number of mentions within 48h
• summary: Token narrative/summary
• twitter / telegram / website: Social links
• m5_buys / h1_buys / h6_buys / h24_buys: Number of buys in the corresponding time window
• user_content: Group members' original discussion content (original group chat text corresponding to this CA)
• liquidity: Liquidity (USD formatted, e.g. 37.5K)
• volume_24h: 24-hour trading volume (USD formatted, e.g. 3.9M)

Display suggestions: Sort by total_mentions , when asked "today's golden dog" sort by (market_cap - first_market_cap) / first_market_cap sort

---

2. Popular CA statistics

Endpoint: GET /api/v1/group_ca/popular

Query Parameters:

• date (date): Statistics date, defaults to current day
• min_count (int): Minimum mention count threshold, default 10
• group_name (string): Group name filter
• limit (int): Number of results to return, default 100
• skip (int): Number of records to skip

Response fields same as CA list, additionally includes:

• mc_change: Market cap change (only returned by popular API){"first_mc": "2.1K", "current_mc": "6.4K", "change_pct": 204.76}
• count: Number of mentions

---

3. Latest CA records

Endpoint: GET /api/v1/group_ca/latest

Query Parameters:

• limit (int): Number of results to return, default 1, max 100

Only return records where ca is not null and http is null.

Recommended to use WebSocket to get CA, faster and more accurate:wss://juhequn.com/ws/new_ca

---

4. Query CA by username

Endpoint: GET /api/v1/group_ca/by-username/{username}

Path Parameters:

• username (string, required): Username

Query Parameters:

• limit (int): Number of results to return, default 50, max 50

Returns at most 50 records.

---

5. Query groups by CA

Input a CA address, returns the list of all groups that have posted this CA.

Endpoint: GET /api/v1/group_ca/query_group

Query Parameters:

• ca (string, required): CA address (exact match)

Response:

{
  "ca": "7m3HtU4RDiXWpAt546HHC7Lho3Qzvz6tx2MiAmLiHpLn",
  "total_groups": 3,
  "groups": ["crazySen群", "孙哥群", "测试群组"]
}

---

6. HTTP link list

Query HTTP links shared in groups (records in the group_ca table where http is not empty).

Endpoint: GET /api/v1/group_http

Query Parameters:

• group_name (string): Group name filter
• limit (int): Number of results to return, default 20, max 100
• skip (int): Number of records to skip
• date (date): Filter by date (YYYY-MM-DD)

Response (fields per record):

{
  "id": 4564,
  "username": "白菜",
  "group_name": "区块日记群",
  "create_time": "2026-03-13T11:34:24",
  "http": "https://example.com",
  "user_content": "这个链接有意思",
  "summary": null,
  "liquidity": null,
  "volume_24h": null
}

7. Query group member discussion

Query the corresponding group member discussion content (user_content) by CA address or HTTP link.

Endpoint: GET /api/v1/group_ca/user_content

Query Parameters:

• ca (string, optional): CA address (exact match)
• http (string, optional): HTTP link (exact match)
• limit (int): Number of results to return, default 20, maximum 100

Note: ca and http at least one must be provided.

Response:

[
  {
    "id": 12345,
    "ca": "0x6106c7d92308bbe4204667a59f9b570288954444",
    "http": null,
    "username": "白菜",
    "group_name": "区块日记群",
    "create_time": "2026-03-13T11:34:24",
    "user_content": "这个币看起来不错，可以关注一下"
  }
]

---

7. AI group chat summary

Endpoint: GET /api/v1/summaries

Query Parameters:

• group_name (string): Group name (fuzzy match)
• date (date): Date, defaults to today
• hour (int): Specify hour (0-23)
• start_date / end_date (datetime): Time range
• limit (int): Number of results to return, default 100

Group category reference:

Type	Groups
Meme/Shitcoin	cryptoD, 0xSun, GDC, James, Golden Frog, 985, Laser Cat, crazySen, 0xAA, AD, Block Diary
Airdrop	leng, Boss P, Xiao Xin, Eleven Landlord, ElevenEleve, 3D Group
New Listing	Long Live China, AKAKAY, Meta

---

8. Daily hot narratives

Endpoint: GET /api/v1/summaries/narratives

Query Parameters:

• date (date): Date, defaults to today

Returns the top 10 CAs with the most mentions, summary(token narrative) field.

---

9. Secondary KOL data

Endpoint: GET /api/v1/second_kol

Query Parameters:

• kol_name (string): KOL name
• token (string): Token filter
• start_date / end_date (date): Time range
• limit (int): Number of results to return, default 50
• skip (int): Number to skip

Response:

[
  {
    "kol_name": "KOL张三",
    "content": "这是一个关于某代币的分析...",
    "token": "ABC123",
    "image_urls": ["https://example.com/img1.png"],
    "sent_at": "2026-03-08T15:30:00"
  }
]

Other KOL endpoints:

• GET /api/v1/second_kol/latest?limit=20 — Latest KOL data
• GET /api/v1/second_kol/kol/{kol_name} — Specified KOL data
• GET /api/v1/second_kol/kol_names — List of all KOL names

Automatically filters content containing blocked words (such as bitget); @everyone is not the token ONE

---

10. News flash

Endpoint	Description
GET /api/v1/newsflash/today	Today's news flash
GET /api/v1/newsflash/date/{date}	News flash for specified date
GET /api/v1/newsflash/latest	Latest news flash

Query Parameters (today/latest):

• limit (int): Number of results to return, default 20

Response:

[
  {
    "add_time": 1741252800,
    "title": "比特币突破新高",
    "content": "比特币价格突破10万美元大关...",
    "url": "https://example.com/news/12345"
  }
]

---

11. Token usage count

Endpoint: GET /api/v1/token/usage

Response:

{
  "token": "aaa3b7ad****b1c",
  "token_name": "API Token 500次/年",
  "daily_limit": 500,
  "used_today": 45,
  "remaining_today": 455,
  "reset_time": "2026-03-09 00:00:00"
}

---

WebSocket real-time push

Base URL: wss://juhequn.com

Pass the Token via URL parameter when connecting:wss://juhequn.com/ws/new_ca?token=YOUR_TOKEN

WS 1. Global new CA push

Endpoint: wss://juhequn.com/ws/new_ca

Starts receiving all new CAs upon connection, no subscription required. Checks the database every 5 seconds.

const ws = new WebSocket('wss://juhequn.com/ws/new_ca?token=YOUR_TOKEN');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === 'new_ca') {
    console.log('新CA:', data.data.ca, '群组:', data.data.group_name);
  }
};

// 心跳
setInterval(() => ws.send('ping'), 30000);

WS 2. Real-time push of group owner messages

Endpoint: wss://juhequn.com/ws/group-owner-messages

After connecting, receives group owner message events; for historical queries use /api/v1/group_owner_messages/latest。

WS 3. Hot CA ranking

Endpoint: wss://juhequn.com/ws/popular_ca

Automatically pushes the hot CA ranking every 30 seconds:

{
  "type": "popular_ca_update",
  "data": [
    {"ca": "0x123...", "count": 25, "rank": 1},
    {"ca": "0x456...", "count": 18, "rank": 2}
  ],
  "timestamp": "2026-03-30T10:30:00"
}

WS 4. Real-time push of new HTTP links

Endpoint: wss://juhequn.com/ws/new_http

Starts receiving all new HTTP links upon connection, no subscription required. Checks the database every 5 seconds.

const ws = new WebSocket('wss://juhequn.com/ws/new_http?token=YOUR_TOKEN');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === 'new_http') {
    console.log('新HTTP:', data.data.http, '群组:', data.data.group_name);
  }
};

// 心跳
setInterval(() => ws.send('ping'), 30000);

Push message format:

{
  "type": "new_http",
  "data": {
    "id": 12345,
    "username": "白菜",
    "group_name": "区块日记群",
    "create_time": "2026-05-18T21:45:18",
    "http": "https://example.com",
    "user_content": "这个链接有意思",
    "summary": null,
    "liquidity": null,
    "volume_24h": null
  },
  "timestamp": "2026-05-18T21:45:18"
}

Note: only pushes records where http is not empty and ca is empty.

---

On-chain data analysis tools

The following are external tools, no Token required, access directly.

Tool	URL	Purpose
DexScreener	https://dexscreener.com/search?q={CA}	Market cap, liquidity, K-line
DexScreener API	https://api.dexscreener.com/latest/dex/tokens/{CA}	Trading pair data (SUI coin type placed directly into {CA}）
GMGN.ai	https://r.jina.ai/http://gmgn.ai/{chain}/token/{CA}	Security audit, holdings distribution
Binance narrative	https://web3.binance.com/...?chainId={id}&contractAddress={CA}	AI narrative analysis
X platform search	https://fapi.uk/api/base/apitools/search?words={CA}	Twitter discussion heat

Chain Parameters: sol / bsc / base / eth / sui / tron

SUI uses the standard coin type:0x plus a 64-bit hexadecimal address, followed by two valid Move identifiers, for example 0x228c580891953873670a13c4dc2e4eb84cae59925a3c774b978af134212092b5::template::TEMPLATE. When querying SUI market data, use DexScreener's sui chain path;marketCap/fdv when missing, treat as null , do not fill with 0. Tron only generates GMGN redirects:https://gmgn.ai/tron/token/JtQgDPzN_{CA}; SUI does not generate GMGN links.

Binance Chain ID: solana=CT_501, bsc=56, base=8453

If an external webpage is blocked, you can prepend https://r.jina.ai/ to the URL as a read-only proxy

---

Error Handling

All response headers include X-Admin-Contact: wechat:erwaNFT

Code	Description
401	Missing Token / Invalid Token
403	Token expired/disabled
404	Record not found
429	Daily call limit reached

{ "detail": "错误描述信息" }

---

Data Table Description

group_ca (about 330,000 records, real-time sync)

CA contract address records, including token information, market cap, buy/sell data, market cap changes, etc.

ai_summary (about 219 records, updated daily)

Feishu group AI summary content.

send_kol

Tier-2 KOL published messages, including content, Token, image links.

newsflash

News flash messages, including title, content, link.

---

Contact Information

WeChat:erwaNFT

API address:https://juhequn.com