API Reference
Silk Alpha provides scored blockchain intelligence for Monad. AI agents pay per query via MPP (Machine Payments Protocol) in USDC.
Base URL: https://api.silknodes.io/v1
Payment: USDC via MPP (HTTP 402 auto-negotiation)
Network: Monad Mainnet (Chain ID 143)
Installation
# npm
npm install @silknodes/monad-intel
# or just use fetch
curl https://api.silknodes.io/v1/api/whale-alerts/free
Quick Start
import { SilkIntel } from '@silknodes/monad-intel';
const silk = new SilkIntel();
const whales = await silk.whaleAlerts({ hours: 24 });
console.log(whales.events[0].signal.reasoning);
// "5th delegation in 48h. Epoch boundary in ~2h."
/whale-alerts
GET
/api/whale-alerts
$0.01 USDC / query
Scored whale movement intelligence with pattern detection, address labeling, and timing signals.
Try it live
Click Run to see a live response...
Query Parameters
| Param | Type | Description |
|---|---|---|
| hours | number | Lookback period (default: 24, max: 168) |
| min_amount | number | Minimum MON amount filter |
| type | string | Filter: transfer, delegate, undelegate |
| limit | number | Max events (default: 50, max: 200) |
Response
{
"events": [{
"id": "c7a0c2f88eae",
"type": "delegate",
"amount_mon": 6247452,
"from": { "label": "Smart Money", "type": "smart_money" },
"to": { "label": "Staking Precompile", "type": "protocol" },
"signal": {
"score": 82,
"pattern": "accumulating",
"timing": "pre-epoch",
"reasoning": "5th delegation in 48h. Epoch boundary in ~2h."
}
}],
"summary": { "last24hVolume": 72500000, "last24hEvents": 47 }
}
/whale-alerts/free
GET
/api/whale-alerts/free
FREE
Delayed (15 min), limited (10 events), no labels or scoring. For evaluation only.
Try it live
Click Run to see a live response...
/yield-brain
GET
/api/yield-brain
$0.02 USDC / query
Ranked yield strategies across native staking, liquid staking (shMON), LP positions, and lending protocols. Risk-adjusted scoring.
Try it live
Click Run to see a live response...
Response
{
"strategies": [
{ "rank": 1, "name": "Stake → Silk Nodes", "apr": "8.2%", "risk": "low" },
{ "rank": 2, "name": "MON/USDC LP", "apr": "24.1%", "risk": "medium" },
{ "rank": 3, "name": "shMON", "apr": "11.4%", "risk": "low" }
],
"sources": ["Monad Staking Precompile", "DefiLlama Yields API"]
}
/status
GET
/api/status
FREE
System health, current epoch, label count.
Node.js SDK
import { SilkIntel } from '@silknodes/monad-intel';
const silk = new SilkIntel({
baseUrl: 'https://api.silknodes.io/v1', // default
network: 'monad', // default
timeout: 10000, // ms
});
// Whale alerts
const whales = await silk.whaleAlerts({ hours: 24, min_amount: 500_000 });
// Yield strategies
const yields = await silk.yieldBrain();
// Health check
const status = await silk.status();
Python (coming soon)
# For now, use requests directly
import requests
resp = requests.get("https://api.silknodes.io/v1/api/whale-alerts",
params={"hours": 24, "min_amount": 100000})
data = resp.json()
for event in data["events"]:
print(f"{event['signal']['score']}: {event['signal']['reasoning']}")