Sleuth Intel REST API — Complete Endpoint Reference

The Sleuth Intel REST API exposes 15 endpoints across five functional areas. Every request requires an Authorization: Bearer YOUR_API_KEY header. Base URL: https://api.sleuthintel.io/v1.

GET /feed

Retrieve a real-time signal feed aggregating on-chain events, prediction market activity, and Crypto Twitter sentiment into a single ranked stream.

integer

default:"50"

Maximum number of signals to return per request.

string

Filter by signal type. Accepted values: wallet, market, signal, social. Omit to return all types.

string

ISO 8601 timestamp. Only return signals created after this time (e.g. 2025-01-01T00:00:00Z).

curl "https://api.sleuthintel.io/v1/feed?limit=10&type=wallet" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

[
  {
    "id": "sig_01hx9z3k2pqr",
    "type": "wallet",
    "entity": "0xabc...123",
    "summary": "Smart wallet accumulated 420,000 SOL in the last 6 hours.",
    "timestamp": "2025-06-10T14:32:00Z",
    "tier_required": "pro"
  },
  {
    "id": "sig_01hx9z4m8wst",
    "type": "social",
    "entity": "BTC",
    "summary": "Bitcoin mindshare spiked 12% in the last hour on CT.",
    "timestamp": "2025-06-10T14:28:00Z",
    "tier_required": "starter"
  }
]

string

Unique signal identifier.

string

Signal category: wallet, market, signal, or social.

string

The asset, wallet address, or market associated with this signal.

string

Human-readable summary of the signal event.

string

ISO 8601 timestamp of when the signal was generated.

string

Minimum subscription tier required to view full signal detail.

GET /signals

Retrieve narrative momentum and mindshare data for tracked assets. Use this endpoint to identify which assets are gaining or losing attention and how sentiment is shifting.

string

Comma-separated list of asset symbols to filter results (e.g. BTC,ETH,SOL). Omit to return all tracked assets.

string

default:"30d"

Lookback window. Accepted values: 7d, 30d.

curl "https://api.sleuthintel.io/v1/signals?assets=BTC,ETH,SOL&range=7d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

[
  {
    "symbol": "SOL",
    "mindshare_pct": 18.4,
    "mindshare_delta": 3.2,
    "sentiment": "bullish",
    "rank": 1
  },
  {
    "symbol": "BTC",
    "mindshare_pct": 14.1,
    "mindshare_delta": -0.8,
    "sentiment": "neutral",
    "rank": 2
  },
  {
    "symbol": "ETH",
    "mindshare_pct": 9.7,
    "mindshare_delta": 1.1,
    "sentiment": "bullish",
    "rank": 3
  }
]

string

Asset ticker symbol.

number

Percentage of total narrative attention captured by this asset.

number

Change in mindshare percentage over the selected range. Positive values indicate growing attention.

string

Aggregated sentiment: bullish, neutral, or bearish.

integer

Asset rank by mindshare within the selected range.

GET /pm-markets

Fetch prediction market odds, volume, and flow data across supported platforms. Use this endpoint to scan open markets, compare pricing across venues, and spot volume anomalies.

string

default:"all"

Filter by prediction market platform. Accepted values: all, rothera, polymarket, kalshi.

string

default:"open"

Filter by market status. Accepted values: open, closed, all.

integer

Maximum number of markets to return.

curl "https://api.sleuthintel.io/v1/pm-markets?platform=polymarket&status=open&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

[
  {
    "id": "mkt_poly_88123",
    "question": "Will BTC close above $120,000 on July 4, 2025?",
    "yes_price": 0.42,
    "no_price": 0.58,
    "volume_24h": 284500,
    "platform": "polymarket"
  },
  {
    "id": "mkt_poly_88204",
    "question": "Will the Fed cut rates in September 2025?",
    "yes_price": 0.67,
    "no_price": 0.33,
    "volume_24h": 1020000,
    "platform": "polymarket"
  }
]

string

Unique market identifier.

string

The market resolution question.

number

Current implied probability of YES (0–1).

number

Current implied probability of NO (0–1).

number

Total trading volume in USD over the last 24 hours.

string

Platform where the market is listed.

GET /pm-traders

Retrieve the prediction market trader leaderboard. Sort by profit, win rate, or closing line value (CLV) to surface the sharpest traders on the platform.

string

default:"clv"

Sort field. Accepted values: pnl, win_rate, clv.

string

default:"30d"

Lookback window. Accepted values: 30d, 90d, all.

integer

Maximum number of traders to return.

curl "https://api.sleuthintel.io/v1/pm-traders?sort=clv&range=90d&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

[
  {
    "wallet": "0xdef...456",
    "pnl": 182400,
    "win_rate": 0.71,
    "clv_score": 4.2,
    "archetype": "sharp"
  },
  {
    "wallet": "0xghi...789",
    "pnl": 94100,
    "win_rate": 0.63,
    "clv_score": 2.8,
    "archetype": "value_hunter"
  }
]

string

Trader wallet address.

number

Total profit and loss in USD over the selected range.

number

Proportion of winning trades (0–1).

number

Closing line value score — a measure of edge relative to closing market prices. Higher is sharper.

string

Behavioral archetype derived from trading patterns (e.g. sharp, value_hunter, fade_target).

GET /discover

Browse the on-chain wallet leaderboard across 250+ chains. Filter by chain, sort by performance metric, and identify the wallets generating consistent alpha.

string

default:"all"

Chain to filter by (e.g. ethereum, solana, base). Pass all for cross-chain results.

string

Sort field. Accepted values: pnl, volume, win_rate.

string

default:"30d"

Lookback window. Accepted values: 7d, 30d, 90d.

integer

Maximum number of wallets to return.

curl "https://api.sleuthintel.io/v1/discover?chain=solana&sort=pnl&range=30d&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

[
  {
    "address": "7xKq...MnP2",
    "chain": "solana",
    "pnl_30d": 2410000,
    "volume_30d": 18500000,
    "win_rate": 0.74,
    "tags": ["whale", "dex_trader", "early_entry"]
  },
  {
    "address": "0xabc...d3f1",
    "chain": "ethereum",
    "pnl_30d": 980000,
    "volume_30d": 7200000,
    "win_rate": 0.61,
    "tags": ["defi", "yield_farmer"]
  }
]

string

Wallet address.

string

Chain where this wallet was ranked.

number

Realized PnL in USD over the last 30 days.

number

Total trading volume in USD over the last 30 days.

number

Proportion of profitable trades (0–1).

array

Behavioral and activity tags assigned to this wallet.

GET /wallet

Retrieve a full intelligence profile for any EVM or Solana wallet address — holdings, PnL, behavioral archetype, and on-chain tags.

string

required

The wallet address to analyze. Accepts EVM (0x…) and Solana formats.

string

Chain identifier (e.g. ethereum, base, solana). If omitted, the API auto-detects the chain from the address format.

curl "https://api.sleuthintel.io/v1/wallet?address=0xabc...123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "address": "0xabc...123",
  "chain": "ethereum",
  "tags": ["whale", "nft_collector", "early_entry"],
  "pnl": {
    "realized_30d": 540000,
    "realized_all_time": 4200000
  },
  "holdings": [
    { "token": "ETH", "amount": 1200, "usd_value": 3840000 },
    { "token": "USDC", "amount": 500000, "usd_value": 500000 }
  ],
  "behavior_archetype": "accumulator"
}

string

The queried wallet address.

string

Detected or specified chain.

array

On-chain behavioral and classification tags.

object

PnL breakdown. Contains realized_30d and realized_all_time in USD.

array

Current token holdings. Each object includes token, amount, and usd_value.

string

Primary behavioral archetype inferred from trading history.

GET /pm-wallet

Retrieve a prediction market-specific intelligence profile for a wallet — total PnL, win rate, closing line value, markets traded, and behavioral archetype.

string

required

The wallet address to analyze for prediction market activity.

curl "https://api.sleuthintel.io/v1/pm-wallet?address=0xdef...456" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "pm_profile": {
    "address": "0xdef...456",
    "total_pnl": 182400,
    "win_rate": 0.71,
    "clv_score": 4.2,
    "markets_traded": 318,
    "archetype": "sharp"
  }
}

string

The queried wallet address.

number

All-time realized PnL across prediction markets in USD.

number

Proportion of winning market positions (0–1).

number

Closing line value score. Reflects how often this wallet beats the closing price — a key sharpness metric.

integer

Total number of distinct markets this wallet has participated in.

string

PM-specific behavioral archetype.

POST /chat

Ask the Sleuth Intel AI assistant a natural language question. The assistant answers from live platform data — signal feeds, wallet rankings, PM odds, and more.

string

required

Your natural language question (e.g. "Who is buying SOL right now?", "Which prediction markets have the most unusual volume today?").

curl -X POST https://api.sleuthintel.io/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Who is buying SOL right now?"}'

const response = await fetch("https://api.sleuthintel.io/v1/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SLEUTH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "Who is buying SOL right now?" }),
});

const data = await response.json();
console.log(data.answer);

import os, requests

response = requests.post(
    "https://api.sleuthintel.io/v1/chat",
    headers={"Authorization": f"Bearer {os.environ['SLEUTH_API_KEY']}"},
    json={"query": "Who is buying SOL right now?"}
)
print(response.json()["answer"])

Example Response

{
  "answer": "Three high-conviction wallets are accumulating SOL in the last 4 hours: 7xKq...MnP2 (+420,000 SOL), GhT3...vWx9 (+180,000 SOL), and Rk8L...9Yp1 (+95,000 SOL). All three have positive CLV scores and are tagged as early-entry smart money.",
  "sources": [
    { "type": "wallet", "entity": "7xKq...MnP2", "signal_id": "sig_01hx9z3k2pqr" },
    { "type": "wallet", "entity": "GhT3...vWx9", "signal_id": "sig_01hx9z4a1lmn" }
  ]
}

string

Natural language answer synthesized from live platform data.

array

Array of source references used to generate the answer. Each object includes type, entity, and signal_id.

The AI assistant pulls from live data at query time. Responses reflect conditions at the moment of your request — re-query for updated context.

GET and POST /alerts

List your configured alerts or create a new one. Alerts deliver Sleuth Intel signals to your Telegram account when specified conditions are met.

Use GET /alerts to retrieve your existing alert configurations and POST /alerts to create a new one. Configure your Telegram handle in Account Settings before creating alerts.

string

required

(POST only) The signal type to alert on. Accepted values: wallet, market, signal, social.

string

(POST only) The specific wallet address, asset symbol, or market ID to monitor.

object

(POST only) Trigger conditions. Structure depends on alert type (e.g. { "pnl_change": 100000 } for wallet alerts).

curl https://api.sleuthintel.io/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.sleuthintel.io/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "wallet",
    "entity": "7xKq...MnP2",
    "threshold": { "pnl_change": 100000 }
  }'

GET Response

[
  {
    "id": "alert_01hx9z7r4abc",
    "type": "wallet",
    "entity": "7xKq...MnP2",
    "threshold": { "pnl_change": 100000 },
    "active": true
  }
]

POST Response

{
  "id": "alert_01hx9z8s5def",
  "type": "wallet",
  "entity": "7xKq...MnP2",
  "threshold": { "pnl_change": 100000 },
  "active": true
}

GET, POST, and DELETE /watchlists

Create, retrieve, and delete custom watchlists for wallets, assets, and prediction markets you want to track.

string

required

(POST only) Display name for the watchlist.

string

required

(POST only) Watchlist category. Accepted values: wallets, assets, markets.

array

required

(POST only) Array of addresses, symbols, or market IDs to include in the watchlist.

string

(DELETE only) The watchlist ID to delete.

curl https://api.sleuthintel.io/v1/watchlists \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.sleuthintel.io/v1/watchlists \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SOL Smart Money",
    "type": "wallets",
    "items": ["7xKq...MnP2", "GhT3...vWx9"]
  }'

curl -X DELETE "https://api.sleuthintel.io/v1/watchlists?id=wl_01hx9za2xyz" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET Response

[
  {
    "id": "wl_01hx9za2xyz",
    "name": "SOL Smart Money",
    "type": "wallets",
    "items": ["7xKq...MnP2", "GhT3...vWx9"],
    "created_at": "2025-06-01T09:00:00Z"
  }
]

POST Response

{
  "id": "wl_01hx9za2xyz",
  "name": "SOL Smart Money",
  "type": "wallets",
  "items": ["7xKq...MnP2", "GhT3...vWx9"],
  "created_at": "2025-06-10T15:00:00Z"
}

DELETE Response

{
  "deleted": true,
  "id": "wl_01hx9za2xyz"
}

GET and POST /alerts

List your configured alerts or create a new one. Alerts deliver Sleuth Intel signals to your Telegram account when specified conditions are met.

Use GET /alerts to retrieve your existing alert configurations and POST /alerts to create a new one. Configure your Telegram handle in Account Settings before creating alerts.

string

required

(POST only) The signal type to alert on. Accepted values: wallet, market, signal, social.

string

(POST only) The specific wallet address, asset symbol, or market ID to monitor.

object

(POST only) Trigger conditions. Structure depends on alert type (e.g. { "pnl_change": 100000 } for wallet alerts).

curl https://api.sleuthintel.io/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.sleuthintel.io/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "wallet",
    "entity": "7xKq...MnP2",
    "threshold": { "pnl_change": 100000 }
  }'

GET Response

[
  {
    "id": "alert_01hx9z7r4abc",
    "type": "wallet",
    "entity": "7xKq...MnP2",
    "threshold": { "pnl_change": 100000 },
    "active": true
  }
]

POST Response

{
  "id": "alert_01hx9z8s5def",
  "type": "wallet",
  "entity": "7xKq...MnP2",
  "threshold": { "pnl_change": 100000 },
  "active": true
}

GET, POST, and DELETE /watchlists

Create, retrieve, and delete custom watchlists for wallets, assets, and prediction markets you want to track.

string

required

(POST only) Display name for the watchlist.

string

required

(POST only) Watchlist category. Accepted values: wallets, assets, markets.

array

required

(POST only) Array of addresses, symbols, or market IDs to include in the watchlist.

string

(DELETE only) The watchlist ID to delete.

curl https://api.sleuthintel.io/v1/watchlists \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.sleuthintel.io/v1/watchlists \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SOL Smart Money",
    "type": "wallets",
    "items": ["7xKq...MnP2", "GhT3...vWx9"]
  }'

curl -X DELETE "https://api.sleuthintel.io/v1/watchlists?id=wl_01hx9za2xyz" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET Response

[
  {
    "id": "wl_01hx9za2xyz",
    "name": "SOL Smart Money",
    "type": "wallets",
    "items": ["7xKq...MnP2", "GhT3...vWx9"],
    "created_at": "2025-06-01T09:00:00Z"
  }
]

POST Response

{
  "id": "wl_01hx9za2xyz",
  "name": "SOL Smart Money",
  "type": "wallets",
  "items": ["7xKq...MnP2", "GhT3...vWx9"],
  "created_at": "2025-06-10T15:00:00Z"
}

DELETE Response

{
  "deleted": true,
  "id": "wl_01hx9za2xyz"
}

API Reference

MCP Integration

Agent Economy

Sleuth Intel REST API — Complete Endpoint Reference

GET /feed

GET /signals

GET /pm-markets

GET /pm-traders

GET /discover

GET /wallet

GET /pm-wallet

POST /chat

GET and POST /alerts

GET, POST, and DELETE /watchlists

GET and POST /alerts

GET, POST, and DELETE /watchlists

​GET /feed

​GET /signals

​GET /pm-markets

​GET /pm-traders

​GET /discover

​GET /wallet

​GET /pm-wallet

​POST /chat

​GET and POST /alerts

​GET, POST, and DELETE /watchlists

​GET and POST /alerts

​GET, POST, and DELETE /watchlists

GET /feed

GET /signals

GET /pm-markets

GET /pm-traders

GET /discover

GET /wallet

GET /pm-wallet

POST /chat

GET and POST /alerts

GET, POST, and DELETE /watchlists

GET and POST /alerts

GET, POST, and DELETE /watchlists