solenrich

SolEnrich

为 Solana Agent 提供链上情报。Agent 只需发送一个请求，通过 x402（在 Solana 或 Base 上）为每次调用支付少量 USDC（无需 API 密钥或账户），即可获取包含依据的判断结果——结构化 JSON，或供大模型使用的简短自然语言简报。

提供判断结果，而非原始数据：代币的 SAFE / CAUTION / RISKY，持仓的 EXIT / DERISK / HOLD，StonkFun 奖励币的 PAYING / STALE / NEVER，币种创建者的 ESTABLISHED / SERIAL_LAUNCHER，以及市场的 RISK_ON / NEUTRAL / RISK_OFF。评分采用确定性方式（流程中不使用大模型），因此相同输入会得到相同答案。工具套件涵盖钱包和代币、迷因币交易（买入和卖出）、聪明钱、五个平台的永续合约，以及 StonkFun 奖励币。每个端点也都是 MCP 服务上的工具。

在线 API： https://api.solenrich.com/ 首页： https://solenrich.com 文档（可供 Agent 阅读）： https://api.solenrich.com/docs

快速开始

# Health check
curl https://api.solenrich.com/health

# Agent card (A2A discovery)
curl https://api.solenrich.com/.well-known/agent.json

# List all 51 endpoints (50 paid + 1 free)
curl https://api.solenrich.com/entrypoints

# Full API documentation (agent-readable JSON)
curl https://api.solenrich.com/docs

# Free demo (no payment required, 10 queries/hr)
curl -X POST https://api.solenrich.com/demo/enrich \
  -H "Content-Type: application/json" \
  -d '{"address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}'

支付方式

1. Agent 在不支付的情况下调用端点。
2. SolEnrich 返回 402 Payment Required，并在 payment-required 标头中提供价格、Solana 和 Base 上的 USDC 收款地址，以及真实的响应示例。
3. Agent 为该价格签署 USDC 转账，并在请求中附上付款信息后重新调用（任何 x402 客户端都可以完成此操作；请参阅 skills/solenrich/examples/x402/）。
4. Coinbase CDP facilitator 在链上结算付款，SolEnrich 随后返回答案。

对于运行时间可能超过约 20 秒的端点，会在开始处理前结算付款，因此即使运行缓慢也不会损失付款。付款记录可在 x402scan 上查看。

端点

所有付费端点都接受发往 /entrypoints/{key}/invoke 的 POST 请求，请求体为包含 input 对象的 JSON。未提供有效的 x402 付款标头时，端点会返回 HTTP 402 和付款说明。

核心（5 个端点）

端点	价格	输入	说明
enrich-wallet-light	$0.002	address, format	SOL 余额、代币持仓、NFT 明细、标签、风险评分
enrich-wallet-full	$0.005	address, format	+ DeFi 持仓、关联钱包、增强的交易历史
enrich-token-light	$0.002	mint, format	价格（3 个来源的中位数）、市值、交易量、流动性、风险标记
enrich-token-full	$0.004	mint, format	+ 前 20 大持有者、HHI 集中度、波动率指标
parse-transaction	$0.001	signature, format	类型检测、协议识别、转账明细

高级（5 个端点）

端点	价格	输入	说明
whale-watch	$0.008	mint, format	跟踪增持和分发情况的主要持有者
batch-enrich	$0.015	addresses[], type, depth, format	并行丰富多达 25 个钱包或代币的信息
wallet-graph	$0.010	address, depth, format	交易关联映射和集群检测
wallet-link-check	$0.030	wallet_a, wallet_b, context, format	两个钱包是否属于同一所有者？根据直接转账、初始资助者、新钱包创建时间和 x402 历史（收款钱包轮换还是遭到劫持）给出判断结果和置信度
copy-trade-signals	$0.010	address, format	PnL、胜率、Sharpe/Sortino 比率、最大回撤
due-diligence	$0.020	mint, format	综合风险报告，包含 SAFE / CAUTION / RISKY 判断结果

比较（2 个端点）

端点	价格	输入	说明
compare-tokens	$0.006	mints[]（2-3）, format	并排比较：价格、流动性、波动率、HHI、风险。排名 + 摘要
compare-wallets	$0.006	addresses[]（2-3）, depth, format	并排比较：投资组合、活动、风险、标签。排名 + 摘要

时间序列（3 个端点）

端点	价格	输入	描述
token-trend	$0.006	mint、lookback、format	随时间变化的代币指标——每日快照，并标示每项指标的上升、下降或稳定趋势
wallet-history	$0.006	address、lookback、format	每日快照中的投资组合价值、SOL 余额、风险评分变化，以及持仓变动
portfolio-history	$0.006	address、period、format	完整的投资组合时间序列（7/14/30 天），包含峰值、谷值、最大回撤及相较起始值的变化

发现与协议（2 个端点）

端点	价格	输入	描述
new-tokens	$0.012	min_liquidity_usd、max_risk_score、limit、format	近期上线的代币，包含丰富信息和风险评分，按安全性从高到低排列
protocol-profile	$0.008	protocol、include_yields、format	协议 TVL、收益率、链上活动、健康信号和自动化活动占比

永续合约情报（8 个端点）

端点	价格	输入	描述
perps-market-structure	$0.012	format	Jupiter Perps 中 SOL/BTC/ETH 的未平仓量、利用率、借款 APR、偏斜度和健康标记
perps-trader-profile	$0.010	address、format	多平台（Jupiter + Adrena）未平仓头寸、杠杆、盈亏及交易者分类
perps-cross-venue-funding	$0.015	market、include_reference、format	Jupiter、Adrena、Hyperliquid、dYdX 的资金费率/借款 APR 和未平仓量——各方向的最佳入场选择及套利价差
perps-venue-comparison	$0.020	market、side、size_usd、format	此规模下在哪个平台交易：滑点、费用、未平仓量空间、总入场成本及建议
perps-basis-signal	$0.015	asset、min_yield_apr_pct、format	扣除借款成本后的基差交易扫描器——各平台实际可赚取的收益率
perps-market-trend	$0.008	lookback、format	7/14/30 天内各市场的变化（价格、未平仓量、偏斜度、利用率、借款 APR）——用于检测市场状态
hyperliquid-trader-profile	$0.012	address（0x）、format	Hyperliquid 实时持仓、杠杆、距清算价的距离、风险标记，以及周/月/历史至今的盈亏
hyperliquid-smart-money	$0.05	market、top_traders、format	排行榜筛选 → 经过持续性筛选的交易者 → 按币种统计的持仓共识 + 顶级交易者深入分析

编排（2 个端点）

端点	价格	输入	描述
trending-signals	$0.050	min_liquidity_usd、max_risk_score、limit、format	热门代币综合排名：结合发现、鲸鱼监控和风险评分，并附带理由
smart-money-flow	$0.100	wallets[]、min_win_rate、lookback_days、format	为种子钱包评分，筛选赢家，找出他们正在累积的代币及相关集群

Trenches — Memecoin 情报（5 个端点）

端点	价格	输入	描述
smart-money-trenches	$0.05	hours_back、max_token_age_hours、min_buyers、limit、format	哪些经过验证的赢家钱包此刻正在冲入新上线的代币（<6h）——基于经过验证的已实现 PnL 种子集，过滤机器人，并按不同聪明买家的数量和近期程度排名
runner-scan	$0.04	max_token_age_hours、min_liquidity_usd、min_volume_h1_usd、limit、format	哪些新代币此刻正在加速——买入速率加速度（5m 对比 1h、1h 对比 6h）、买入压力、成交量／价格速度、持有人增长、流动性趋势。分阶段标记为 RUNNING / IGNITING / PARABOLIC_LATE / FADING，并给出 0–1 分数。将已大幅上涨的代币标记为入场风险，并将 LP 撤出标记为 rug
trenches-scan	$0.08	max_token_age_hours、min_liquidity_usd、limit、format	一次调用获取全部三项 Trenches 信号——链上速度 × 经过验证的赢家买入 × Agent 关注度，综合成排序列表，包含信号共振数、逐个代币的分析理由，以及 HIGH_CONFLUENCE / MODERATE / SINGLE_SIGNAL 结论
trenches-check	$0.03	mint、format	将整套分析用于一个代币——冲入之前，先运行检查。与 trenches-scan 使用相同的三项信号，但针对你的候选代币：结论 + 分析理由 + 各信号详情。可与 due-diligence 搭配，进行完整的入场前评估
exit-signal	$0.04	mint、entry_price_usd、format	针对你持有的代币给出卖出结论——EXIT / DERISK / HOLD，并附带 0–1 的退出分数。卖压、买入速率减缓、成交量衰退、趁势派发、主要持有人资金流向（鲸鱼是在派发还是增持）、流动性趋势、持有人换手。rug 触发条件（LP 撤出、正在发生的抛售）优先于其他所有信号。适用于任何存续时间的代币

Collectibles / RWA（1 个端点）

端点	价格	输入	描述
gacha-ev-scan	$0.02	machine、franchise、exit_strategy、min_edge_pct、format	Jupiter Gacha（Collector Crypt）卡包 EV 扫描——比较含保险的总 EV、保证的即时回购底价（85–93%，≤72h）和市场销售（−2% 费用，有成交风险）。按机器给出 POSITIVE_EV / HOUSE_EDGE / NEGATIVE_EV 结论——平台在总 EV 标题背后隐藏的可实现 EV

StonkFun — 报价配对代币与奖励币（5 个端点，其中 1 个免费）

在 stonkfun.xyz 上发行的代币以报价资产定价（如 NVDAX/SPYX/TSLAX 等 xStocks、Backpack 预上市股票、货币、自定义 mint）。奖励模式代币带有 Token-2022 转账税（100 或 300 bps），并以报价代币的形式支付给持有人。这些端点会从链上读取税费配置、评估税费是否能到达持有人手中、计算持有人收益率、筛查全部奖励币，并在广播前预检自行构建的 LaunchLab 发币流程。

端点	价格	输入	描述
stonk-pairs	免费	category、launchable_only、format	可与发行配对的报价资产、规范化类别，以及 is_agent_launchable 标记（可发行 + 已准备好 LaunchLab + 类别获准）。首先调用：发行的 quoteMint 必须是其中之一
stonk-reward-risk	$0.005	mint、format	派发状态——PAYING（持有者在过去 24 小时内收到派发）、STALE、NEVER、NOT_REWARD——以及 trading_cost（税费 bps、往返百分比）和 0–100 健康评分。评分从链上读取：费用 bps + 上限、提现权限（必须是 StonkFun 的分发器）、费用可变性、派发及其时效、飞轮效应、持有者及集中度、报价类别、币龄
stonk-yield-batch	$0.05	mints（最多 25 个）或筛选器条件、limit（≤25）、format	单次调用即可通过索引在毫秒内获取最多 25 种代币的 stonk-yield：每种代币的 7 天 / 30 天 / 累计收益率、奖励资产、市值、持有者数量、上次派发时间。比调用 stonk-screener 再为每种代币分别调用一次 stonk-yield 更便宜
stonk-alerts	$0.02	mints（1–25 个）、since、min_holders_change_pct、stale_after_hours、format	自上次检查以来奖励代币的变化：已派发奖励、派发过期、停止交易、持有者数量变化、已派发奖励总额。此外还提供每种代币当前的派发状态。通过索引在毫秒内获取；轮询时将 checked_at 作为 since 传回
stonk-yield	$0.005	mint、format	过去 7 天 / 30 天 / 累计的持有者收益率——报价资产奖励按美元计价，再除以平均市值；不足 7 天时会年化并附带谨慎提示。此外还包括报价资产敞口：持有者同时做多该代币 和 其报价资产
stonk-screener	$0.01	quote_mint、category、min_holders、min_age_days、max_age_days、min_volume_24h_usd、max_market_cap_usd、paying_only、live_only、sort、limit、format	对 10 分钟内采集的所有奖励代币进行筛选，并从内存中提供结果。每行包括：payout_status、距上次派发的小时数、live（过去 24 小时内有交易 AND 有派发）、round_trip_pct 税费成本、持有者数量、收益率、交易量、市值。可按 volume24h（默认）、lastPayout、holders、priceChange24h、yield7d、yield30d、rewardsUsd 排序
stonk-gems	$0.03	quote_mint、category、max_age_days、min_holders、max_market_cap_usd、limit、format	活跃代币精选列表：根据近期持有者派发、持有者数量、市值增长空间、24 小时换手率、币龄、动量、报价强度和飞轮效应，为奖励代币评定 0–100 分。每种代币会标记为 GEM / WATCH / NOISE / DEAD，并附上原因和警告。衡量代币是否存续、派发奖励并具有流动性，而非预测价格（在一次模拟测试中，高分代币的表现并未跑赢市场）；可与 stonk-creator 和 stonk-quote 搭配使用
stonk-launch-intel	$0.02	category、min_coins、sort、limit、format	应发行什么代币，以及使用什么资产作为报价资产。每种报价资产的数据包括：发行数量（24 小时 / 7 天）、今日有交易的比例、今日有派发的比例、存续超过第 3 天的比例、持有者数量和市值中位数、100 与 300 bps 税费的交易 / 派发比例、竞争拥挤程度、0–100 需求评分；另含整体统计数据和通俗易懂的建议
stonk-quote	$0.005	mint、size_usd、hold_days、format	估算单笔交易在指定金额下的成本和回本情况，不执行兑换：买入 / 卖出成本（税费 + 价格影响）、往返百分比和盈亏平衡所需价格变动、按持仓比例计算的派发份额及微额警告、根据真实收益率历史估算持有期间的预期派发，以及 PAYS / MARGINAL / COSTS / NOT_PAYING 状态和盈亏平衡所需持有天数
stonk-market-pulse	$0.005	format	StonkFun 市场是在上涨还是下跌？根据市场广度（24 小时内上涨的活跃代币占比）和中位数涨跌幅，给出 RISK_ON / NEUTRAL / RISK_OFF 状态；另含成交量加权涨跌幅、每日发行数量、有交易和有派发的比例、持有者过去 7 天与此前 7 天的收入、最强和最弱的报价资产板块，以及每日市场广度趋势
stonk-creator	$0.01	creator 或 mint、format	跟踪 StonkFun 创建者的记录：ESTABLISHED / MIXED / SERIAL_LAUNCHER / NEW、每日和每周发行数量、发行超过 3 天后仍在交易的代币占比（一次性创建者的基准为 19%，而连续发行者为 5%）、过去 24 小时内的派发情况和存续代币
stonk-launch-preflight	$0.25	unsigned_transaction、quote_mint、mode、launch_params、format	解码 LaunchLab 初始化指令，并将每个参数与 StonkFun 的 /launchlab/pricing 逐项比对——GlobalConfig、各模式的平台 ID、曲线、供应量、totalSellA、募集金额、6 位小数的 Token-2022 基础铸币账户、报价代币程序、最后的曲线规则账户，以及奖励模式的转账费用（可捕获 Raydium 中拼错的 transferFeeBasePoints / maxinumFee）。返回 ok、mismatches[{field, expected, actual, fix}] 和 warnings。不匹配的池绝不会被采纳：税费将无人受益

情报动态与信号（4 个端点）

端点	价格	输入	描述
feed-latest	$0.005	since、format	每日情报简报——预先计算的趋势排名，缓存 24 小时，专为定期轮询而设计
consensus-signal	$0.005	address/type 或 limit、window、format	其他 Agent 当前正在查询的内容——根据我们的请求流生成的专有关注度信号
attention-momentum	$0.02	window、limit、format	按 Agent 关注度的加速度排名的代币，并显示价格背离：early_signal（关注度上升、价格持平）/ distribution_risk（关注度降温、价格上涨）
check-alerts	$0.008	tokens[]、wallets[]、since、criteria、format	基于轮询的提醒：价格飙升、巨鲸资金流、风险变化及永续合约事件（加仓/平仓、即将清算、盈亏波动）

自然语言（1 个端点）

端点	价格	输入	描述
query	$0.003	question、format	将自然语言问题路由到相应的增强器

请求示例

curl -X POST https://api.solenrich.com/entrypoints/compare-tokens/invoke \
  -H "Content-Type: application/json" \
  -d '{"mints":["JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],"format":"both"}'

请求正文为扁平 JSON，符合 /openapi.json 中各端点的架构。也接受 {"input": {...}} 封装格式。

输出格式

每个端点都接受 format 参数：

• json —— 供 Agent 间使用的结构化数据
• llm —— 供大模型上下文窗口使用的自然语言简报（Markdown）
• both —— JSON 数据，并附加 llm_summary 字段

评分方法

所有评分均采用确定性的链上逻辑——整个处理流程中不使用任何大模型推理。

钱包风险评分（0.0 - 1.0）

根据链上活动计算的七项累加因素：

因素	权重
交易集中度高（交易对手较少）	+0.15
交易多样性低	+0.10
新钱包（创建时间不足 30 天）	+0.15
类似机器人的模式（频率高、重复性强）	+0.20
与已知高风险程序交互	+0.15
空投耕种信号（大量小额代币账户）	+0.10
协议多样性低（少于 2 个协议）	+0.10

风险等级： LOW（< 0.25）| MODERATE（0.25-0.50）| ELEVATED（0.50-0.65）| HIGH（0.65-0.80）| CRITICAL（> 0.80）

HHI（赫芬达尔-赫希曼指数）

根据链上持仓量排名前 20 的持有者计算集中度指标：

• < 1500 —— 分布良好
• 1500-2500 —— 中度集中
• > 2500 —— 高度集中

价格波动性

根据 DexScreener 多时间范围数据计算（不产生额外 API 调用）：

• LOW —— 日标准差 < 3%
• MODERATE —— 3-8%
• HIGH —— 8-15%
• EXTREME —— > 15%

代币定价

取最多 3 个来源（Helius DAS、DexScreener、Jupiter）的中位数。中位数可抵御任一单独 DEX 的异常值。

架构

Client → x402 Paywall → Entrypoint Router → Enrichment Engine → Format Router → Response

仓库结构

路径	内容
src/enrichers/	评分逻辑：每个增强器都会获取、交叉核验并评分。判定规则是带有单元测试的纯函数（例如 stonk-creator.ts、stonk-pulse.ts、wallet-link.ts、risk-scorer.ts）。
src/entrypoints/	每个端点套件对应一个文件：输入架构、处理程序和简报。
src/sources/	Helius、Solana RPC、DexScreener、Jupiter、Birdeye、DeFi Llama、StonkFun 和永续合约交易平台的客户端。
src/lib/agent.ts	应用设置、x402 支付中间件、指标、/docs。
src/mcp-tools.ts	MCP 服务的工具（每个端点对应一个）。
src/openapi.ts、src/lib/llms-txt.ts	发现入口：OpenAPI、llms.txt。
agents/solscout/	我们的测试 Agent：在生产环境中为每个端点付费并检查响应。
skills/solenrich/	可安装的 Agent 技能。
test/	单元测试（在 CI 中运行）和实时端点检查。

数据源

来源	用途
Helius	DAS API（资产、代币账户）、增强型交易解析、RPC
DexScreener	代币价格、市场数据、流动性、OHLCV
DeFi Llama	协议 TVL、收益数据
Jupiter	代币价格（交叉参考）、元数据、验证状态、永续合约报价
Birdeye	实际持有者数量、用于计算波动率的每日 OHLCV
Solana RPC	SOL 余额、铸币信息、前 20 大持有者、Token-2022 转账手续费、Jupiter Perps、Adrena 和 Flash 链上账户
StonkFun 公共 API	奖励代币、支付款项、发布账本（创建者）、收入历史
Hyperliquid + dYdX v4	跨链永续合约参考（资金费率、基差）

实体标注

20 多个已知 Solana 地址会在所有增强结果中自动标记：CEX 钱包（Binance、Coinbase）、协议地址（Raydium、Orca、Jupiter）、跨链桥和基金会。

NFT 分类

Solana 钱包中的大多数非同质化资产都是未经请求的压缩空投，因此原始 NFT 数量会夸大收藏活动。一个经测量的钱包持有 118 个非同质化资产：15 个是真正持有的，103 个是空投，其中有几个是诱骗用户的陷阱。

钱包增强结果会返回 nft_summary，其中包含三个类别，数量总和等于 nft_count：

类别	含义
collected	未压缩且未标记为垃圾内容。铸造这些资产时，每个资产都需要支付租金，因此通常是有意购买或铸造的。
airdropped	已压缩且未标记为垃圾内容。批量铸造成本低，因此通常是未经请求发送的。
suspected_spam	名称或描述中包含诱导领取的内容、嵌入的域名，或用于规避过滤器的不可见字符。

nft_collections 会列出规模最大的系列，并将真正持有的资产排在前面。distinct_collections 只统计属于具名系列的已收集资产。

垃圾内容检测仅针对已压缩资产的名称和描述进行模式匹配。应将其视为信号，而非定论——带有宣传措辞的合法压缩空投也可能被标记。nft_collector 标签要求至少有 10 个 collected NFT，因此不再会因空投数量而触发。

Agent 技能

只需一行，即可将 SolEnrich 技能安装到 Claude Code、Cursor、Codex 及其他能够读取 Agent Skills 的 Agent 中。该技能会教 Agent 哪个端点可以回答哪类问题、如何通过 x402 按次付费，以及 交易和 StonkFun 工作流：

npx skills add 0xSardius/solenrich --skill solenrich

来源：skills/solenrich/。已列入 skills.sh。 数据调用需付费（x402，使用 Solana 或 Base 上的 USDC）；Agent 需要一个持有 USDC 的钱包。

MCP 服务

SolEnrich 为 Claude Desktop、Claude Code 和 Cursor 提供 MCP 端点。无需安装：

{
  "mcpServers": {
    "solenrich": {
      "type": "streamable-http",
      "url": "https://api.solenrich.com/mcp"
    }
  }
}

共 49 个工具——每个端点都作为 MCP 工具公开（钱包/代币的轻量版和完整版本合并为 depth/include_holders 开关）。主要工具：enrich_wallet、enrich_token、due_diligence、whale_watch、perps_cross_venue_funding、trending_signals、smart_money_flow、check_alerts。

免费试用

无需付费即可试用 SolEnrich——粘贴任意 Solana 钱包地址或代币铸币地址：

curl -X POST https://api.solenrich.com/demo/enrich \
  -H "Content-Type: application/json" \
  -d '{"address":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"}'

每个 IP 每小时可免费查询 10 次。自动识别钱包或代币。返回 format: "both"（JSON + 大模型摘要）。

登录页上的交互式演示：https://solenrich.com

开发

# Install dependencies
bun install

# Start dev server (port 3000)
bun run dev

# Type check
bunx tsc --noEmit

# Run tests (CI runs the unit test files: 500+ tests across 15 files, see .github/workflows/ci.yml)
bun test test/unit.test.ts                # core unit tests
bun test test/stonk.test.ts               # StonkFun suite (recorded fixtures)
bun run test/test-all-endpoints.ts        # live endpoint checks (requires a running server)
bun run test/test-402-production.ts       # production paywall verification
bun run agents/solscout/index.ts --target production --mode stress   # free 402 check of every route

环境变量

变量	必需	描述
HELIUS_API_KEY	是	Helius API 密钥（helius.dev）
AGENT_WALLET_ADDRESS	是	用于付款的 Solana 钱包地址
PAYMENTS_ENABLED	否	设置为 "true" 以启用 x402 付费墙
FACILITATOR_URL	如果启用付款	x402 协调器 URL
UPSTASH_REDIS_REST_URL	否	用于缓存的 Upstash Redis（回退到内存缓存）
UPSTASH_REDIS_REST_TOKEN	否	Upstash Redis 令牌
JUPITER_API_KEY	否	Jupiter API 密钥（可选，免费套餐即可使用）
BIRDEYE_API_KEY	否	Birdeye API 密钥——用于获取真实持有者数量和每日 OHLCV 数据以计算波动率
METRICS_TOKEN	否	GET /metrics 的 Bearer 令牌；未设置时，生产环境中的指标会被锁定
EVM_PAY_TO	否	用于 USDC 付款的 Base 地址；设置后，每个 402 响应也会提供在 Base 上付款的选项
DOGFOOD_WALLETS	否	以逗号分隔的付款方钱包地址（属于我们，用于测试的 Agent）；这些地址不会计入自然增长数据和关注度信号

部署

使用 Docker（Bun 运行时）部署在 Railway 上。会从 main 分支自动部署。

许可证

MIT

构建者

@0xSardius