security.token_prescreen | GET /v1/security/token-prescreen | $0.01 | Pre-trade check, cheapest tier — batch-screening filter: LP lock/burn status (same GoPlus call as contract_health_audit, no extra upstream cost) plus GeckoTerminal top-pool USD liquidity (same source as dex.liquidity_slippage) in one minimal response. Run this first across many candidates to cheaply drop the ones with no real liquidity or unlocked LP, then only spend token_risk/contract_health_audit/token_diagnostic on survivors. No honeypot/tax/mint checks and no LP-holder breakdown — see those tools for that. liquidity_usd is null when chain_id isn't mapped to GeckoTerminal (currently Base, Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche); LP lock data is unaffected. |
security.token_authenticity | GET /v1/security/token-authenticity | $0.01 | Pre-trade check, cheapest tier — flags contracts impersonating a known mainstream asset (e.g. a fake "USDC"), using GoPlus's fake_token/trust_list/honeypot_with_same_creator fields (same GoPlus call as token-risk/contract-health-audit/token-prescreen, no extra upstream cost). flagged_as_counterfeit: false is not proof of authenticity — it only means GoPlus found no such flag at query time; true_token_address is only set when flagged_as_counterfeit is true. No honeypot/tax/LP checks — see token_risk/contract_health_audit for those. No Honeypot.is fallback exists for these fields. |
security.token_risk | GET /v1/security/token-risk | $0.02 | Pre-trade check — call before buying or swapping: GoPlus/Honeypot.is-backed contract security audit (honeypot flag, buy/sell tax, mintability, ownership renouncement, plus individual GoPlus signals — cannot_sell_all, hidden_owner, transfer_pausable, selfdestruct, is_blacklisted, slippage_modifiable, owner concentration — folded into risk_flags). Screening many candidates? security.token_prescreen ($0.01) is a cheaper first-pass filter before paying for this. |
security.contract_health_audit | GET /v1/security/contract-health-audit | $0.02 | Pre-trade check — LP (liquidity pool) lock/burn audit reusing the same GoPlus data as token-risk: flags whether liquidity is locked, burned, or freely held by a single wallet before you trust it. Screening many candidates? security.token_prescreen ($0.01) reuses this same LP-lock check plus a liquidity figure, for less. |
security.token_diagnostic | GET /v1/security/token-diagnostic | $0.03 | Pre-trade check — bundles token_risk + contract_health_audit into one call (same GoPlus data, no new upstream calls) for a single go/no-go input before a swap. No composite score or letter grade — just both tools' fields plus a deduped risk_flags union. Cheaper than calling both separately. Screening many candidates? security.token_prescreen ($0.01) is a cheaper first-pass filter before paying for this. |
dex.liquidity_slippage | GET /v1/dex/liquidity-slippage | $0.02 | GeckoTerminal-backed DEX pool liquidity and estimated trade slippage, plus fixed $1k/$5k/$10k slippage_tiers, pool_fee_pct, an assumed_gas_cost_usd estimate, and quote_token_is_stablecoin (flags when the picked pool isn't USD-quoted and an extra hop is needed) for at-a-glance depth checks. When called with token_address, also returns direct_stablecoin_pool_exists and, when the picked pool isn't USD-quoted, alternate_direct_pool (a different pool for the same token that is) - so you know before swapping whether a multi-hop route is actually required. |
derivatives.whale_position_audit | GET /v1/derivatives/whale-position-audit | $0.02 | Audits a Hyperliquid wallet address you supply: open positions, leverage, max_leverage, liquidation price, PnL, and return_on_equity_pct (the latter two Hyperliquid's own reported fields). Does not discover or rank wallets - Hyperliquid's public API has no leaderboard endpoint. |
derivatives.funding_rate | GET /v1/derivatives/funding-rate | $0.01 | Bybit (primary) / Binance (fallback) perpetual futures funding rate, plus mark_price/index_price (both paths) and open_interest_usd (Bybit path only, null on the Binance fallback). |
derivatives.funding_rate_value | GET /v1/derivatives/funding-rate-value | $0.001 | Cheap tier — thin wrapper around funding_rate: same cached call, trimmed to just funding_rate/funding_rate_percentage (no mark/index price, no open interest). No new upstream call. |
derivatives.funding_apr_matrix | GET /v1/derivatives/funding-apr-matrix | $0.01 | Annualizes the current funding rate into an APR and computes carry-trade breakeven days against an assumed round-trip trading cost. |
arb.spread_matrix | GET /v1/arb/spread-matrix | $0.02 | CEX (Coinbase spot) vs DEX (GeckoTerminal) spread calculator with gas-adjusted profitability flag, plus pool_fee_pct (informational - not subtracted from the spread). |
prediction.neg_risk_arbitrage | GET /v1/prediction/neg-risk-arbitrage | $0.03 | Detects basket arbitrage in a Polymarket neg-risk (mutually-exclusive, multi-outcome) event — a full YES basket always settles to $1, so a basket price away from $1 (after costs) is a near risk-free edge. Also returns the actual liquidity-bottleneck size executable right now (VWAP-priced, not just top-of-book), and oldest_book_snapshot_time (staleness bottleneck across legs). Polymarket only. |
prediction.exit_capacity_audit | GET /v1/prediction/exit-capacity-audit | $0.02 | Walks a Polymarket outcome's live order book to check whether a given position size can actually be filled right now, at what average price and price impact, plus book_snapshot_time/tick_size/min_order_size. Resolves by token_id or an exact market_slug. |
prediction.order_split_guide | GET /v1/prediction/order-split-guide | $0.02 | Walks a Polymarket outcome's live order book to recommend how many clips to split a large position into so each clip's own price impact stays at or under max_price_impact_pct_per_slice (default 1.0%), plus full_size_price_impact_pct as a one-shot baseline for comparison. Single-snapshot calculation — has no idea whether the book refills between clips in real trading, see the response's own notice field. Reuses exit_capacity_audit's order-book helpers, no new upstream call. Resolves by token_id or an exact market_slug. |
prediction.bid_ask_spread_pct | GET /v1/prediction/bid-ask-spread-pct | $0.001 | Cheap tier — a single Polymarket outcome's live top-of-book bid/ask spread as a percentage of mid_price. Not a liquidity or executability measure (use exit_capacity_audit/order_split_guide for that). Reuses the same order-book fetch, no new upstream call. Resolves by token_id or an exact market_slug. |
prediction.orderbook_imbalance_ratio | GET /v1/prediction/orderbook-imbalance-ratio | $0.01 | A single Polymarket outcome's bid-side vs ask-side order-book depth ratio, summed within depth_band_pct (default 5.0%) of each side's own best quote — 0.5 = balanced, closer to 1.0 = bid-side dominant, closer to 0.0 = ask-side dominant. Purely descriptive — not a prediction of price direction, no confidence/verdict field. Reuses the same order-book fetch, no new upstream call. Resolves by token_id or an exact market_slug. |
prediction.liquidity_depth_after_haircut | GET /v1/prediction/liquidity-depth-after-haircut | $0.02 | A single Polymarket outcome's executable depth within max_price_impact_pct (default 5.0%) of the best quote, both before and after discounting the top-of-book level's size by haircut_pct (default 10.0%) — models best-quote cancellation risk, does not detect or flag actual spoofing (out of scope, see architecture-roadmap.md Phase 3). Reuses the same order-book fetch, no new upstream call. Resolves by token_id or an exact market_slug. |
prediction.polymarket_fee_estimate | GET /v1/prediction/polymarket-fee-estimate | $0.01 | Polymarket's own taker fee (shares * fee_rate * price * (1 - price), the official bell-curve formula) for a hypothetical fill — NOT gas, slippage, or AlphaPipeline's own charge. fee_rate is read live from Polymarket's own GET /fee-rate for the exact token_id, never a hardcoded category table (per-category rates have changed before — see architecture-roadmap.md Engineering Precision Backlog item 3). Makers pay 0 everywhere; taker fee only. Omit price to use the live best book quote. Resolves by token_id or an exact market_slug. |
prediction.polymarket_mispricing | GET /v1/prediction/polymarket-mispricing | $0.03 | Monotonicity check (higher strike must not be priced above a lower strike) across Polymarket markets you assert already share the same settlement condition — this endpoint does not verify or infer that equivalence itself (Polymarket's API has no reliable field for it; see architecture-roadmap.md Engineering Precision Backlog item 4 and the response's own notice). Accepts token_ids or market_slugs (+ optional outcomes). Not investment advice. |
prediction.hip4_snapshot | GET /v1/prediction/hip4-snapshot | $0.01 | Real-time probability snapshot of Hyperliquid's HIP-4 outcome markets — crypto price binaries, sports game winners, tournament winners, Fed rate decisions, and any new market type Hyperliquid adds, all in one call. No curated market list: every fields value is parsed verbatim from Hyperliquid's own description string. Optional template/underlying filters narrow the result. Hyperliquid only. |
prediction.hip4_price_ladder | GET /v1/prediction/hip4-price-ladder | $0.01 | One underlying's HIP-4 "above $X" price-binary markets sorted into a strike ladder, each rung with its live Yes probability — read the market's implied price distribution at a glance instead of scanning hip4_snapshot's raw list. Reuses hip4_snapshot's cached data (no new upstream call). No volume field: Hyperliquid doesn't expose per-outcome volume for HIP-4. Required underlying. Hyperliquid only. |
prediction.hip4_price | GET /v1/prediction/hip4-price | $0.002 | Cheap tier — single-rung lookup: reuses hip4_price_ladder's cached data and returns only the one rung whose strike is closest to your requested strike, with matched_strike so you can tell when no close rung exists. No new upstream call. Required underlying, strike. Hyperliquid only. |
prediction.hip4_mispricing | GET /v1/prediction/hip4-mispricing | $0.02 | Finds monotonicity violations among a single underlying's HIP-4 "above $X" price-binary markets: within the same expiry/period, a higher strike's Yes price should never exceed a lower strike's — any reversal is flagged with violation_bp and a textbook max_riskless_profit_per_usd (the violation size itself, before fees/slippage/execution risk — not investment advice). Reuses hip4_price_ladder's cached data, no new upstream call. Only rungs sharing the exact same (expiry, period) are ever compared (see settlement_condition_note). Required underlying. Hyperliquid only. |
market.cycle_compare | GET /v1/market/cycle-compare | $0.01 | BTC/ETH price return since the current halving (2024-04-20) vs. the same elapsed days in the 2016 and 2020 post-halving cycles, plus today's real BTC dominance and DXY/US 10Y macro context. Reads a daily-refreshed cache (no live upstream call at request time). Raw price comparison, not true market-cap dominance history — see the response's own notice field. No ETH 2016-cycle figures (ETH didn't exist yet). |
market.oracle_gap | GET /v1/market/oracle-gap | $0.01 | Single-snapshot gap between Hyperliquid's mid price and its mark/oracle prices for one perpetual — the failure mode behind the 2026-10-10 Papertrade incident on HyperEVM (a protocol priced off raw mid instead of mark/oracle; an attacker moved ~$2.31B notional on Hyperliquid itself to swing the mid ~12bp, netting ~$1.28M). Returns mid_oracle_gap_bp/mark_oracle_gap_bp in basis points plus a fixed-threshold elevated flag (abs(mid_oracle_gap_bp) >= alert_threshold_bp) — not a manipulation determination. Single point-in-time snapshot, no trade-flow/volume data (Hyperliquid doesn't expose per-market volume). |
market.oracle_gap_bp | GET /v1/market/oracle-gap-bp | $0.001 | Cheap tier — thin wrapper around oracle_gap: same cached call, trimmed to just the bp gap numbers and the elevated flag (no absolute mid/mark/oracle prices). No new upstream call. |
calendar.macro_dday | GET /v1/calendar/macro-dday | $0.01 | Countdown to the nearest major US macro event (FOMC, CPI, NFP) from a static, pre-loaded calendar — no external API call, never fails on an upstream outage. |
tools.ai_markdown | GET /v1/tools/ai-markdown | $0.005 | Converts any webpage URL into clean, ad-free Markdown optimized for LLM context windows. |
market.kimchi_alert | GET /v1/market/kimchi-alert | Free | Real-time Korea (Upbit) vs global reference price (Coinbase spot, CoinGecko fallback — not a live Binance orderbook) premium — the "kimchi premium" — with reverse-premium and 1h-surge alerts. Kept free by default as an onboarding tool: informational market context, not part of the paid pre-trade security cluster. |
unlocks.dump_risk | GET /v1/unlocks/dump-risk | Free | On-chain (Sablier) proxy for token unlock/vesting dump risk, including vesting_progress_pct (withdrawn/deposit) showing how far along vesting already is. Kept free by default as an onboarding tool so agents can verify the service before paying for the rest. |
[EXPERIMENTAL] events.hip4_alerts | GET /v1/prediction/hip4-alerts/event-types (free) · GET /v1/prediction/hip4-alerts/subscribe ($0.02) · POST /v1/prediction/hip4-alerts/unsubscribe (free) | See below | Webhook push alerts on HIP-4 probability jumps / new markets, instead of polling hip4_snapshot yourself. Disabled by default (HIP4_EVENTS_ENABLED=false) - see "Event subscriptions" below. |