SolEnrich — Solana Onchain Intelligence for Agents
SolEnrich turns raw Solana data into verdicts an agent can act on: SAFE / CAUTION / RISKY for a token,
EXIT / DERISK / HOLD for a position you hold, GEM / WATCH / NOISE for a StonkFun coin, best venue for a
perp at your size. 52 paid endpoints plus one free, $0.001 to $0.25 per call, settled over x402. No
account, no API key: the agent pays USDC per request from its own wallet.
Base URL: https://api.solenrich.com
Overview
Use this skill when the user asks about:
- Is this token safe, is it a rug, who holds it, how much slippage at size
- Is this wallet risky, is it a bot, what does it hold, how has it performed
- Where is smart money moving, which proven-winner wallets are buying fresh launches
- Should I enter, should I exit, is this memecoin still running (the trenches lifecycle)
- Which perps venue has the best funding or the lowest entry cost for SOL / BTC / ETH
- Which StonkFun reward coins are paying holders, which look like gems, what to launch against
- Any plain-English Solana question the agent cannot answer from one source
All scoring is deterministic. There is no LLM in SolEnrich's pipeline; the llm format is a template,
so a briefing costs the same as JSON and never hallucinates.
Instructions
- Discover for free.
GET /docs (every endpoint with input schema and scoring methodology),
GET /openapi.json, GET /llms.txt, GET /.well-known/x402. Read resources/endpoints.md in
this skill for the decision table with prices.
- Choose the payment path.
- Agent has a Solana wallet with USDC → x402 from code. Read
resources/x402.md, then use
examples/x402/pay-per-request.ts. Base USDC works the same way with the EVM scheme.
- Agent has a terminal →
pay curl from the Solana Foundation pay CLI handles the 402 challenge
and returns the body. Install: npm i -g @solana/pay.
- No wallet at all →
POST /demo/enrich is free (10 calls per hour, one token or wallet) and
stonk-pairs is free. The MCP endpoint https://api.solenrich.com/mcp lists tools but returns
payment instructions instead of data.
- Call the endpoint. Every paid route is
POST /entrypoints/{key}/invoke with a JSON body. A flat
body works ({ "mint": "...", "format": "llm" }) and so does an input envelope
({ "input": { ... } }). format is json (default), llm (briefing), or both.
- Pick the endpoint by intent.
| User intent |
Endpoint |
Price |
| Is this token safe / rug check with a verdict |
due-diligence |
$0.02 |
| Quick token price, liquidity, slippage, risk flags |
enrich-token-light |
$0.002 |
| Token holders, concentration (HHI), volatility |
enrich-token-full |
$0.004 |
| Is this wallet risky, is it a bot, what does it hold |
enrich-wallet-light |
$0.002 |
| Wallet DeFi positions, connected wallets, tx history |
enrich-wallet-full |
$0.005 |
| Does this wallet trade well (PnL, win rate, Sharpe) |
copy-trade-signals |
$0.01 |
| Who are the whales and are they buying or selling |
whale-watch |
$0.008 |
| What are proven winners buying on spot |
smart-money-flow |
$0.10 |
| Which winners are aping fresh (<6h) launches right now |
smart-money-trenches |
$0.05 |
| Which fresh tokens are accelerating right now |
runner-scan |
$0.04 |
| Should I enter THIS token (velocity + smart money + attention) |
trenches-check |
$0.03 |
| Should I exit the token I hold |
exit-signal |
$0.04 |
| Should my AudaceFi league agent send this swap intent |
audace-intent-check |
$0.05 |
| Best venue for a SOL / BTC / ETH perp at my size |
perps-venue-comparison |
$0.02 |
| Funding and OI across Jupiter, Adrena, Flash, Phoenix, Hyperliquid, dYdX |
perps-cross-venue-funding |
$0.015 |
| Is the xStock vs Phoenix perp basis trade worth it at my size (NVDA, SPY, QQQ, …) |
xstock-basis |
$0.015 |
| Where is Hyperliquid smart money positioned |
hyperliquid-smart-money |
$0.05 |
| Which StonkFun coins look early, real, and paying |
stonk-gems |
$0.03 |
| Is this StonkFun coin paying holders, what does the tax cost |
stonk-reward-risk |
$0.005 |
| What do these StonkFun coins yield (up to 25 in one call) |
stonk-yield-batch |
$0.05 |
| Did my StonkFun coins pay today, did any go stale (watchlist, poll hourly) |
stonk-alerts |
$0.02 |
| What does a StonkFun trade cost at my size, and does the coin pay it back |
stonk-quote |
$0.005 |
| What to launch on StonkFun and against which quote |
stonk-launch-intel |
$0.02 |
| A plain-English question, unsure which endpoint |
query |
$0.003 |
Full table with inputs and the remaining endpoints: resources/endpoints.md.
- Chain the trade lifecycle in this order. Find → vet → size → hold → exit:
runner-scan or smart-money-trenches → trenches-check on one mint → due-diligence →
enrich-token-light for slippage at size → exit-signal while holding. Every response carries a
next_steps array naming the next call. See examples/trade-lifecycle.md.
- Read the transfer tax. Token-2022 mints (all StonkFun reward coins) carry a
transfer_tax block
on token, runner, trenches-check, and exit-signal responses. round_trip_pct is the buy plus sell
cost before slippage; exit-signal.position.net_pnl_after_exit_tax_pct is the number to act on.
- Present verdicts first, evidence second. Lead with the verdict word and score, then the two or
three reasons the response gives, then the caveats. Never drop the
caveats array; it says which
legs failed or what the data cannot see.
Examples
Token safety with a verdict
User: "Is BONK safe to hold?"
import { createPaidFetch } from './examples/x402/pay-per-request';
const fetch402 = await createPaidFetch();
const res = await fetch402('https://api.solenrich.com/entrypoints/due-diligence/invoke', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ mint: 'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263', format: 'both' }),
});
const { verdict, risk_score, risk_factors, llm_summary } = await res.json();
Reply with the verdict, the score, the top risk factors, and the slippage line from the summary.
Same call from a terminal
pay curl -X POST https://api.solenrich.com/entrypoints/due-diligence/invoke \
-H 'content-type: application/json' \
-d '{"mint":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263","format":"llm"}'
Should I exit
User: "I bought ZCAT at 0.10, should I sell?"
Call exit-signal with { "mint": "<ZCAT mint>", "entry_price_usd": 0.10 }. Report verdict,
exit_score, position.unrealized_pnl_pct, and position.net_pnl_after_exit_tax_pct (ZCAT carries a
300 bps tax, so the net figure is lower). Quote the reasoning string.
Find StonkFun gems
User: "What's worth looking at on StonkFun right now?"
Call stonk-gems with { "limit": 10, "format": "llm" }. Show the GEM rows with their reasons and
warnings, and say that the list refreshes every ten minutes. Follow with trenches-check on any GEM the
user wants to size.
Watch StonkFun holdings
User: "Tell me if any of my StonkFun coins stop paying."
Call stonk-alerts with { "mints": ["<mint>", "..."], "since": "<last check, ISO>" } (up to 25 mints).
Report payout_stale and stopped_trading first, then rewards_since. Keep checked_at from the
response and pass it as since on the next check. For yields across the same coins in one call, use
stonk-yield-batch with { "mints": [...] }.
Plain-English fallback
User: "Should I buy JUP?"
Call query with { "question": "Should I buy JUP?" }. It chains due-diligence, token-trend, and
whale-watch and returns one answer. Use query when the intent is compound or unclear; use the specific
endpoint when it is clear, because it is cheaper and returns typed fields.
Guidelines
- DO start with
-light endpoints ($0.002) and escalate to -full or due-diligence only when the
light result flags something.
- DO pass
format: "llm" when the result feeds a context window; it is shorter and reads better.
- DO respect cache windows: results are cached server-side 30 seconds to 10 minutes by data type.
Re-polling faster spends money for the same answer. Trenches endpoints unlock liquidity and holder
deltas on a second call 5 or more minutes later, not sooner.
- DO use
batch-enrich for three or more addresses; it amortizes overhead.
- DON'T call
whale-watch or enrich-token-full before due-diligence; it already bundles them.
- DON'T treat any verdict as financial advice or auto-execute a trade on it. Confirm with the user
before any swap.
- DON'T send the private key anywhere except the local x402 signer. SolEnrich never sees it.
- Prices are per call in USDC. Read the
pricing block of any 402 response for the live number.
Common Errors
HTTP 402 with a JSON body
Cause: No payment header, or the payment was rejected. The body carries pricing, how_to_pay,
and all_endpoints (every paid key with its price).
Solution: Use the x402 fetch wrapper or pay curl. Confirm the wallet holds USDC and a little SOL
for fees on Solana, or USDC on Base.
HTTP 404 on /entrypoints/<key>/invoke
Cause: Unknown endpoint key. Keys are lowercase with hyphens, for example enrich-wallet-light.
Solution: GET /entrypoints lists every key.
HTTP 400 validation error
Cause: Wrong field name or an address that is not base58 (Solana) or 0x (Hyperliquid endpoints).
Solution: Field names are snake_case (entry_price_usd, max_age_days). Check the schema in
GET /docs or GET /openapi.json.
index is warming up caveat on stonk endpoints
Cause: The server just restarted; the 10-minute StonkFun index rebuilds within a minute.
Solution: Retry after 60 seconds.
holders_source: unavailable or a leg marked FAILED in caveats
Cause: An upstream source (RPC, DexScreener, Jupiter) timed out. Verdicts degrade instead of failing.
Solution: Report the caveat with the verdict. Retry later if the missing leg matters.
References
1---2name: solenrich3description: SolEnrich onchain intelligence API for Solana agents, pay-per-call over x402 (USDC on Solana or Base) with no API key. Use for StonkFun reward coins (gems, payout status and watchlist alerts, holder yield for one coin or 25, trade cost and payback, launch intel), wallet risk scoring, token due diligence and rug flags, smart-money and whale tracking, memecoin trenches entry and exit verdicts (runner-scan, trenches-check, exit-signal), cross-venue perps funding and venue comparison (Jupiter, Adrena, Flash, Phoenix, Hyperliquid, dYdX), and plain-English questions routed to the right enricher. Returns JSON or an LLM-ready briefing.4metadata:5 source: https://skillmd.com/skills/jiayaoqijia/solenrich6---78# SolEnrich — Solana Onchain Intelligence for Agents910SolEnrich turns raw Solana data into verdicts an agent can act on: SAFE / CAUTION / RISKY for a token,11EXIT / DERISK / HOLD for a position you hold, GEM / WATCH / NOISE for a StonkFun coin, best venue for a12perp at your size. 52 paid endpoints plus one free, $0.001 to $0.25 per call, settled over x402. No13account, no API key: the agent pays USDC per request from its own wallet.1415Base URL: `https://api.solenrich.com`1617## Overview1819Use this skill when the user asks about:2021- Is this token safe, is it a rug, who holds it, how much slippage at size22- Is this wallet risky, is it a bot, what does it hold, how has it performed23- Where is smart money moving, which proven-winner wallets are buying fresh launches24- Should I enter, should I exit, is this memecoin still running (the trenches lifecycle)25- Which perps venue has the best funding or the lowest entry cost for SOL / BTC / ETH26- Which StonkFun reward coins are paying holders, which look like gems, what to launch against27- Any plain-English Solana question the agent cannot answer from one source2829All scoring is deterministic. There is no LLM in SolEnrich's pipeline; the `llm` format is a template,30so a briefing costs the same as JSON and never hallucinates.3132## Instructions33341. **Discover for free.** `GET /docs` (every endpoint with input schema and scoring methodology),35 `GET /openapi.json`, `GET /llms.txt`, `GET /.well-known/x402`. Read `resources/endpoints.md` in36 this skill for the decision table with prices.372. **Choose the payment path.**38 - Agent has a Solana wallet with USDC → x402 from code. Read `resources/x402.md`, then use39 `examples/x402/pay-per-request.ts`. Base USDC works the same way with the EVM scheme.40 - Agent has a terminal → `pay curl` from the Solana Foundation `pay` CLI handles the 402 challenge41 and returns the body. Install: `npm i -g @solana/pay`.42 - No wallet at all → `POST /demo/enrich` is free (10 calls per hour, one token or wallet) and43 `stonk-pairs` is free. The MCP endpoint `https://api.solenrich.com/mcp` lists tools but returns44 payment instructions instead of data.453. **Call the endpoint.** Every paid route is `POST /entrypoints/{key}/invoke` with a JSON body. A flat46 body works (`{ "mint": "...", "format": "llm" }`) and so does an `input` envelope47 (`{ "input": { ... } }`). `format` is `json` (default), `llm` (briefing), or `both`.484. **Pick the endpoint by intent.**4950| User intent | Endpoint | Price |51|---|---|---|52| Is this token safe / rug check with a verdict | `due-diligence` | $0.02 |53| Quick token price, liquidity, slippage, risk flags | `enrich-token-light` | $0.002 |54| Token holders, concentration (HHI), volatility | `enrich-token-full` | $0.004 |55| Is this wallet risky, is it a bot, what does it hold | `enrich-wallet-light` | $0.002 |56| Wallet DeFi positions, connected wallets, tx history | `enrich-wallet-full` | $0.005 |57| Does this wallet trade well (PnL, win rate, Sharpe) | `copy-trade-signals` | $0.01 |58| Who are the whales and are they buying or selling | `whale-watch` | $0.008 |59| What are proven winners buying on spot | `smart-money-flow` | $0.10 |60| Which winners are aping fresh (<6h) launches right now | `smart-money-trenches` | $0.05 |61| Which fresh tokens are accelerating right now | `runner-scan` | $0.04 |62| Should I enter THIS token (velocity + smart money + attention) | `trenches-check` | $0.03 |63| Should I exit the token I hold | `exit-signal` | $0.04 |64| Should my AudaceFi league agent send this swap intent | `audace-intent-check` | $0.05 |65| Best venue for a SOL / BTC / ETH perp at my size | `perps-venue-comparison` | $0.02 |66| Funding and OI across Jupiter, Adrena, Flash, Phoenix, Hyperliquid, dYdX | `perps-cross-venue-funding` | $0.015 |67| Is the xStock vs Phoenix perp basis trade worth it at my size (NVDA, SPY, QQQ, …) | `xstock-basis` | $0.015 |68| Where is Hyperliquid smart money positioned | `hyperliquid-smart-money` | $0.05 |69| Which StonkFun coins look early, real, and paying | `stonk-gems` | $0.03 |70| Is this StonkFun coin paying holders, what does the tax cost | `stonk-reward-risk` | $0.005 |71| What do these StonkFun coins yield (up to 25 in one call) | `stonk-yield-batch` | $0.05 |72| Did my StonkFun coins pay today, did any go stale (watchlist, poll hourly) | `stonk-alerts` | $0.02 |73| What does a StonkFun trade cost at my size, and does the coin pay it back | `stonk-quote` | $0.005 |74| What to launch on StonkFun and against which quote | `stonk-launch-intel` | $0.02 |75| A plain-English question, unsure which endpoint | `query` | $0.003 |7677 Full table with inputs and the remaining endpoints: `resources/endpoints.md`.78795. **Chain the trade lifecycle in this order.** Find → vet → size → hold → exit:80 `runner-scan` or `smart-money-trenches` → `trenches-check` on one mint → `due-diligence` →81 `enrich-token-light` for slippage at size → `exit-signal` while holding. Every response carries a82 `next_steps` array naming the next call. See `examples/trade-lifecycle.md`.836. **Read the transfer tax.** Token-2022 mints (all StonkFun reward coins) carry a `transfer_tax` block84 on token, runner, trenches-check, and exit-signal responses. `round_trip_pct` is the buy plus sell85 cost before slippage; `exit-signal.position.net_pnl_after_exit_tax_pct` is the number to act on.867. **Present verdicts first, evidence second.** Lead with the verdict word and score, then the two or87 three reasons the response gives, then the caveats. Never drop the `caveats` array; it says which88 legs failed or what the data cannot see.8990## Examples9192### Token safety with a verdict9394User: "Is BONK safe to hold?"9596```typescript97import { createPaidFetch } from './examples/x402/pay-per-request';98const fetch402 = await createPaidFetch();99const res = await fetch402('https://api.solenrich.com/entrypoints/due-diligence/invoke', {100 method: 'POST',101 headers: { 'content-type': 'application/json' },102 body: JSON.stringify({ mint: 'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263', format: 'both' }),103});104const { verdict, risk_score, risk_factors, llm_summary } = await res.json();105```106107Reply with the verdict, the score, the top risk factors, and the slippage line from the summary.108109### Same call from a terminal110111```bash112pay curl -X POST https://api.solenrich.com/entrypoints/due-diligence/invoke \113 -H 'content-type: application/json' \114 -d '{"mint":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263","format":"llm"}'115```116117### Should I exit118119User: "I bought ZCAT at 0.10, should I sell?"120121Call `exit-signal` with `{ "mint": "<ZCAT mint>", "entry_price_usd": 0.10 }`. Report `verdict`,122`exit_score`, `position.unrealized_pnl_pct`, and `position.net_pnl_after_exit_tax_pct` (ZCAT carries a123300 bps tax, so the net figure is lower). Quote the `reasoning` string.124125### Find StonkFun gems126127User: "What's worth looking at on StonkFun right now?"128129Call `stonk-gems` with `{ "limit": 10, "format": "llm" }`. Show the GEM rows with their reasons and130warnings, and say that the list refreshes every ten minutes. Follow with `trenches-check` on any GEM the131user wants to size.132133### Watch StonkFun holdings134135User: "Tell me if any of my StonkFun coins stop paying."136137Call `stonk-alerts` with `{ "mints": ["<mint>", "..."], "since": "<last check, ISO>" }` (up to 25 mints).138Report `payout_stale` and `stopped_trading` first, then `rewards_since`. Keep `checked_at` from the139response and pass it as `since` on the next check. For yields across the same coins in one call, use140`stonk-yield-batch` with `{ "mints": [...] }`.141142### Plain-English fallback143144User: "Should I buy JUP?"145146Call `query` with `{ "question": "Should I buy JUP?" }`. It chains due-diligence, token-trend, and147whale-watch and returns one answer. Use `query` when the intent is compound or unclear; use the specific148endpoint when it is clear, because it is cheaper and returns typed fields.149150## Guidelines151152- **DO** start with `-light` endpoints ($0.002) and escalate to `-full` or `due-diligence` only when the153 light result flags something.154- **DO** pass `format: "llm"` when the result feeds a context window; it is shorter and reads better.155- **DO** respect cache windows: results are cached server-side 30 seconds to 10 minutes by data type.156 Re-polling faster spends money for the same answer. Trenches endpoints unlock liquidity and holder157 deltas on a second call 5 or more minutes later, not sooner.158- **DO** use `batch-enrich` for three or more addresses; it amortizes overhead.159- **DON'T** call `whale-watch` or `enrich-token-full` before `due-diligence`; it already bundles them.160- **DON'T** treat any verdict as financial advice or auto-execute a trade on it. Confirm with the user161 before any swap.162- **DON'T** send the private key anywhere except the local x402 signer. SolEnrich never sees it.163- Prices are per call in USDC. Read the `pricing` block of any 402 response for the live number.164165## Common Errors166167### HTTP 402 with a JSON body168**Cause**: No payment header, or the payment was rejected. The body carries `pricing`, `how_to_pay`,169and `all_endpoints` (every paid key with its price).170**Solution**: Use the x402 fetch wrapper or `pay curl`. Confirm the wallet holds USDC and a little SOL171for fees on Solana, or USDC on Base.172173### HTTP 404 on `/entrypoints/<key>/invoke`174**Cause**: Unknown endpoint key. Keys are lowercase with hyphens, for example `enrich-wallet-light`.175**Solution**: `GET /entrypoints` lists every key.176177### HTTP 400 validation error178**Cause**: Wrong field name or an address that is not base58 (Solana) or 0x (Hyperliquid endpoints).179**Solution**: Field names are snake_case (`entry_price_usd`, `max_age_days`). Check the schema in180`GET /docs` or `GET /openapi.json`.181182### `index is warming up` caveat on stonk endpoints183**Cause**: The server just restarted; the 10-minute StonkFun index rebuilds within a minute.184**Solution**: Retry after 60 seconds.185186### `holders_source: unavailable` or a leg marked FAILED in `caveats`187**Cause**: An upstream source (RPC, DexScreener, Jupiter) timed out. Verdicts degrade instead of failing.188**Solution**: Report the caveat with the verdict. Retry later if the missing leg matters.189190## References191192- Docs (agent-readable JSON): https://api.solenrich.com/docs193- OpenAPI: https://api.solenrich.com/openapi.json194- LLM summary of every endpoint: https://api.solenrich.com/llms.txt195- x402 discovery: https://api.solenrich.com/.well-known/x402196- MCP (tool listing): https://api.solenrich.com/mcp197- Landing and pricing: https://solenrich.com198- x402 protocol: https://www.x402.org/199- Solana Foundation `pay` CLI: https://github.com/solana-foundation/pay