Documentation Index Fetch the complete documentation index at: https://docs.metengine.xyz/llms.txt
Use this file to discover all available pages before exploring further.
74 endpoints across three platforms. Each table shows the HTTP method, path, pricing tier, and key parameters.
For full parameter specs, response schemas, and fallback strategies, see the complete skill spec .
Pricing Tiers Tier Base Cost Description Light $0.01 Simple lookups and search Medium $0.02 Trending, aggregates, activity feeds Heavy $0.05 Scoring, leaderboards, insider detection Whale $0.08 Multi-entity comparisons, opportunity scans
Multipliers apply for timeframe (0.5x for 1h up to 5.0x for all-time), result limits, and filter removal. Every request lands between 0.01 a n d 0.01 and 0.01 an d
Free pricing endpoint: GET https://agent.metengine.xyz/api/v1/pricing
Polymarket (38 Endpoints) Prediction market intelligence on Polygon. Wallet addresses must be lowercase . condition_id identifies a market; token_id identifies an outcome. Prices represent implied probability (0 to 1).
Market Discovery Method Path Tier Description GET /api/v1/markets/trendingMedium Markets with highest recent volume GET /api/v1/markets/searchLight Search markets by keyword, category, status GET /api/v1/markets/categoriesLight List categories with optional volume stats GET /api/v1/markets/similarWhale Markets similar to a given condition_id GET /api/v1/markets/resolutionsLight Recently resolved markets GET /api/v1/markets/closing-soonLight Markets closing within a time window (1-72h)
Smart Money Intelligence Method Path Tier Description POST /api/v1/markets/intelligenceHeavy Full smart money breakdown for a market POST /api/v1/markets/insidersHeavy Detect insider-pattern wallets on a market GET /api/v1/markets/high-convictionHeavy Markets where smart wallets cluster GET /api/v1/markets/opportunitiesWhale Multi-signal opportunity scanner (capped $0.15) GET /api/v1/markets/dumb-moneyMedium Low-score wallet activity on a market
Trades and Flow Method Path Tier Description GET /api/v1/markets/tradesLight Trade feed for a market GET /api/v1/trades/whalesMedium Large trades across all markets GET /api/v1/markets/capital-flowMedium Capital movement by category GET /api/v1/markets/volume-heatmapMedium Volume distribution across markets
Price and Sentiment Method Path Tier Description GET /api/v1/markets/price-historyLight OHLCV time series for a market POST /api/v1/markets/sentimentMedium Buy/sell sentiment over time POST /api/v1/markets/participantsMedium Participant breakdown for a market
Wallet Profiling Method Path Tier Description POST /api/v1/wallets/profileHeavy Full dossier: PnL, positions, activity POST /api/v1/wallets/activityMedium Recent trades for a wallet POST /api/v1/wallets/pnl-breakdownMedium PnL by market for a wallet POST /api/v1/wallets/compareWhale Side-by-side wallet comparison POST /api/v1/wallets/copy-tradersWhale Find wallets that copy a given wallet (capped $0.12)
Signals & Flow Method Path Tier Description GET /api/v1/markets/smart-signalsHeavy Per-market aggregated smart wallet directional signals POST /api/v1/markets/smart-flowMedium Smart money accumulation vs distribution time series GET /api/v1/markets/new-smart-interestHeavy Markets with first-time smart wallet positions GET /api/v1/markets/dumb-consensusHeavy Global dumb money consensus (contrarian indicator) GET /api/v1/markets/capital-flow-comparisonMedium Multi-timeframe capital flow comparison (sector rotation) GET /api/v1/markets/early-moversMedium Earliest buyers for a market GET /api/v1/markets/ownershipMedium Token ownership distribution for a market GET /api/v1/markets/volume-by-groupMedium Volume grouped by category, hour, or day with period comparison
Leaderboards Method Path Tier Description GET /api/v1/wallets/top-performersHeavy Ranked by Sharpe, ROI, win rate GET /api/v1/wallets/niche-expertsHeavy Top wallets within a category GET /api/v1/wallets/alpha-callersHeavy Wallets that trade early on later-trending markets GET /api/v1/wallets/insidersHeavy Wallets with insider-pattern behavior GET /api/v1/wallets/insiders/trendMedium Insider activity trend over time POST /api/v1/wallets/portfolioWhale Aggregate portfolio view for a watchlist of wallets GET /api/v1/platform/statsLight Platform-wide volume and market counts
Polymarket Quirks Known issues to handle in your agent:
/markets/opportunities frequently returns 504. Fallback to /markets/high-conviction./trades/whales includes REDEEM trades (resolved payouts). Filter by side=BUY or side=SELL if you only want active trades.Wallet addresses must be lowercase hex. Trader addresses are case-insensitive.
Hyperliquid (18 Endpoints) Perpetual futures analytics on Hyperliquid L1. PnL is realized only (no unrealized). Smart score threshold is 85+ (stricter than Polymarket’s 60). Coin symbols are uppercase base only (BTC, not BTC-USDC).
Method Path Tier Description GET /api/v1/hl/platform/statsLight Platform-wide stats GET /api/v1/hl/coins/trendingMedium Coins with highest volume spikes GET /api/v1/hl/coins/listLight All tracked coins GET /api/v1/hl/coins/volume-heatmapMedium Volume distribution across coins
Trader Intelligence Method Path Tier Description GET /api/v1/hl/traders/leaderboardHeavy Traders ranked by PnL, ROI, volume, win rate POST /api/v1/hl/traders/profileHeavy Full trader profile with trade history POST /api/v1/hl/traders/compareWhale Side-by-side trader comparison GET /api/v1/hl/traders/daily-pnlMedium Daily PnL time series POST /api/v1/hl/traders/pnl-by-coinMedium PnL broken down by coin GET /api/v1/hl/traders/fresh-whalesHeavy New high-volume accounts (potential insiders)
Trades and Pressure Method Path Tier Description GET /api/v1/hl/trades/whalesMedium Large trades across all coins GET /api/v1/hl/trades/feedLight Recent trade feed for a coin GET /api/v1/hl/trades/long-short-ratioMedium Long/short volume ratio over time GET /api/v1/hl/pressure/pairsHeavy Buy/sell pressure for specific coins GET /api/v1/hl/pressure/summaryMedium Market-wide pressure overview
Smart Wallets Method Path Tier Description GET /api/v1/hl/smart-wallets/listLight All tracked smart wallets GET /api/v1/hl/smart-wallets/activityMedium Recent smart wallet trades GET /api/v1/hl/smart-wallets/signalsHeavy Aggregated directional signals by coin
Hyperliquid Quirks Known issues to handle in your agent:
timeframe=24h on trending and signal endpoints often returns empty. Fallback to timeframe=7d./long-short-ratio may return zeros. Reconstruct from /trades/whales if needed./traders/profile has intermittent 500s. Use the leaderboard endpoint plus /traders/pnl-by-coin as a workaround. Meteora (18 Endpoints) Solana LP analytics across DLMM and DAMM v2 pool types. Addresses are base58 Solana pubkeys (case-sensitive). Specify pool_type=dlmm or pool_type=damm_v2 where applicable.
Pool Discovery Method Path Tier Description GET /api/v1/meteora/pools/trendingMedium Pools with highest volume spikes GET /api/v1/meteora/pools/topMedium Top pools by liquidity, volume, or fees GET /api/v1/meteora/pools/searchLight Search pools by token name or address GET /api/v1/meteora/pools/detailMedium Full detail for a specific pool GET /api/v1/meteora/pools/smart-walletHeavy Pools with highest smart wallet participation
Pool Analytics Method Path Tier Description GET /api/v1/meteora/pools/volume-historyLight Volume time series for a pool GET /api/v1/meteora/pools/eventsLight Recent deposit/withdraw/claim events GET /api/v1/meteora/pools/fee-analysisMedium Fee claiming patterns and rates
LP Intelligence Method Path Tier Description GET /api/v1/meteora/lps/topHeavy Top LPs ranked by volume, events, or pool count POST /api/v1/meteora/lps/profileHeavy Full LP profile with positions and history GET /api/v1/meteora/lps/whalesMedium Large LP deposits and withdrawals POST /api/v1/meteora/lps/compareWhale Side-by-side LP comparison
Method Path Tier Description GET /api/v1/meteora/positions/activeMedium Active positions for a pool or wallet GET /api/v1/meteora/positions/historyLight Event history for a specific position GET /api/v1/meteora/platform/statsLight Platform-wide LP stats GET /api/v1/meteora/platform/volume-heatmapMedium Volume distribution across pools GET /api/v1/meteora/platform/metengine-shareLight MetEngine’s share of platform volume GET /api/v1/meteora/dca/pressureMedium DCA accumulation intensity for a token
Meteora Quirks Known issues to handle in your agent:
DAMM v2 fee rates on new launches can look implausible (30-50% of volume). This is a data artifact, not real fees.
/pools/trending may return duplicate pool entries. Deduplicate by pool_address./lps/top?sort_by=fees can return 500. Fallback to sort_by=volume.DLMM events use PascalCase field names; DAMM v2 events use snake_case.
Metric Value Median latency 800ms p95 latency 3s p99 latency 8s Timeout 60s (no charge) Max concurrent requests 50
Trade data updates sub-minute. Wallet scores recompute daily.
Health Check Free, no payment required:
GET https://agent.metengine.xyz/health
Returns service status, backend health, and facilitator operational state.
Full Specification
skill.md Complete spec with every parameter, response schema, fallback strategy, and scoring model detail.
