Surf

Active

by Monid

Crypto market, derivatives, and on-chain data.

FinanceData

Endpoints · 105

x402 URLhttps://x402.monid.ai/v1/run
GET/onchain/bridge/ranking$0.012List bridge protocols ranked by USD volume over a time range.
GET/token/dex-trades$0.024Returns recent DEX swap events for a token contract address.
GET/prediction-market/kalshi/trades$0.024Returns individual trade records for a Kalshi market.
GET/hyperliquid/trades$0.024Returns a wallet's closed round-trip trades — one row per open→close position lifecycle, with realized per-trade P&L (gross, net = gross − fees, fees, and funding_pnl as a separate field that net EXCLUDES), entry/exit price, size, and hold time.
GET/exchange/markets$0.01Returns trading pairs available on an exchange.
GET/token/tokenomics$0.012Returns token unlock time-series with cumulative amounts, allocation breakdowns, total supply denominator, and unlocked-supply percentage.
GET/prediction-market/kalshi/open-interest$0.024Daily open interest time series for a Kalshi market.
GET/prediction-market/polymarket/markets$0.024Returns Polymarket markets, filtered by market_slug, which is REQUIRED.
GET/prediction-market/kalshi/volumes$0.024Daily trading volume time series for a Kalshi market.
POST/onchain/sql/preflight$0.024Validate and cost-estimate a ClickHouse SQL query (EXPLAIN ESTIMATE) without executing it.
GET/market/liquidation/order$0.012Returns individual large liquidation orders above a USD threshold (min_amount, default 10000).
GET/market/fear-greed$0.012Returns Bitcoin Fear & Greed Index history.
GET/search/events$0.01Searches project events by keyword, optionally filtered by type.
GET/wallet/detail$0.012Returns a wallet's cross-chain portfolio with selectable sub-resources (balance, tokens, labels, NFTs).
GET/prediction-market/correlations$0.024Returns 30-day Pearson price correlation pairs between Polymarket markets within a category.
GET/market/liquidation/exchange-list$0.012Returns liquidation breakdown by exchange in a single ranked snapshot.
GET/prediction-market/kalshi/markets$0.024Returns Kalshi markets, optionally filtered by market_ticker.
GET/hyperliquid/performance$0.024Returns the connected user's lifetime trading-performance summary — the dashboard header: re-rolled realized performance (win rate, profit factor, gross/net PnL — funding-excluded, net = gross − fees), the live position snapshot, and account value.
GET/hyperliquid/candles$0.024Returns market OHLCV candles for charting and trade-review overlays, ordered by open_time ascending.
GET/wallet/labels/batch$0.012Returns entity labels for multiple wallet addresses.
GET/exchange/klines$0.01Returns OHLCV candlestick data with period summary stats (high, low, total volume).
GET/prediction-market/polymarket/volume-split/{condition_id}$0.024Volume split by YES/NO outcome sides per interval (hour/day/week), plus total volume and trade count.
GET/hyperliquid/orders$0.024Returns a wallet's live resting orders (open — stops, take-profits, limits, with trigger type) plus its recent terminal orders (historical — filled / canceled / rejected).
GET/exchange/coverage$0.01Returns covered spot markets on Bithumb, Upbit, HashKey, bitFlyer, Coinone, and Korbit with latest ticker metrics, candle availability, technical score, and data status.
GET/market/options$0.012Returns options market data for a symbol.
GET/market/etf$0.012Returns daily spot ETF flow history.
GET/search/airdrop$0.01Searches and filters airdrop opportunities.
GET/exchange/long-short-ratio$0.01Returns historical long/short ratio for a perpetual contract.
GET/project/ai-news$0.012AI-generated news and signal analysis for a project.
GET/prediction-market/polymarket/trades$0.024Trade and activity history for a Polymarket market or wallet.
GET/market/liquidation/chart$0.012Returns OHLC-style aggregated liquidation data for a token on a specific exchange.
GET/prediction-market/kalshi/orderbooks$0.024Historical orderbook snapshots for a Kalshi market.
GET/prediction-market/matching/pairs$0.024Cross-platform prediction market pair matcher — finds the same event listed on both Polymarket and Kalshi, with live price spread data.
GET/search/wallet$0.024Searches wallets by ENS name, address label, or address prefix.
GET/market/tge$0.012Returns Token Generation Event (TGE) status for a project.
GET/search/news$0.01Searches crypto news articles by keyword.
GET/project/defi/metrics$0.012Returns historical time-series for a single DeFi protocol metric (e.g. daily TVL).
GET/onchain/tx$0.012Look up one transaction by hash.
GET/fund/portfolio$0.01Returns investment rounds for a fund's portfolio, sorted by date (newest first).
GET/prediction-market/polymarket/prices$0.024Simple price time series for a Polymarket market — one price point per interval.
GET/hyperliquid/positions$0.024Returns a wallet's open perpetual positions with its cross-margin summary and derived risk (leverage, unrealized PnL, ROE, liquidation price, margin ratio, distance-to-liquidation).
GET/heatscore/projects$0.024Returns a paginated ranked snapshot of project signal cards.
GET/wallet/history$0.012Returns all on-chain transactions for a wallet, classified by type (send, receive, swap, approve) with native token value.
GET/onchain/gas-price$0.012Look up the current gas price for one EVM chain.
GET/search/web$0.01Searches web pages, articles, and content by keyword.
GET/prediction-market/polymarket/smart-money$0.024Smart wallet analytics for Polymarket markets.
GET/fund/ranking$0.01Returns top crypto VC funds ranked by tier or portfolio count.
GET/prediction-market/analytics$0.024Trends, top markets, momentum distribution, and per-market momentum signals for prediction markets.
GET/market/onchain-indicator$0.012Returns on-chain indicator time-series for BTC or ETH.
POST/onchain/query$0.024Query on-chain tables with structured JSON filters — no SQL text.
GET/token/transfers$0.012Returns recent transfer events for a specific token (ERC-20/TRC-20 contract).
GET/heatscore/token-of-week$0.024Returns the token-of-week project signal cards with latest price, price-change percentages, dimension scores, compact signals, and AI summaries.
GET/prediction-market/kalshi/events$0.024Returns Kalshi events with nested markets, optionally filtered by event_ticker.
GET/market/public-sale$0.012Returns public sale (IDO/ICO/IEO) information for a project.
GET/news/feed$0.01Returns crypto news from major sources.
GET/wallet/net-worth$0.012Returns a time-series of the wallet's total net worth in USD.
GET/onchain/dex/activity$0.012Active traders, trade count, and USD volume for a DEX protocol (or a specific router contract), as a single aggregate or a daily series (group_by=day).
GET/hyperliquid/trades/context$0.024Returns immutable funding and leverage context for one closed trade identified by the composite key from /hyperliquid/trades.
GET/market/ranking$0.012Returns a token leaderboard sorted by market cap, 24h change, or volume.
GET/onchain/schema$0.024List the on-chain SQL tables and their columns — call this before writing a query for /onchain/query or /onchain/sql.
GET/token/transfer-counterparties$0.012Ranked top counterparties (receivers or senders) of a token over a window — answers "who are the top receivers/senders?".
GET/heatscore/token-of-the-day$0.024Returns the token-of-the-day project signal cards with latest price, price-change percentages, dimension scores, compact signals, and AI summaries.
GET/hyperliquid/leaderboard$0.024Returns traders ranked by a chosen performance metric (PnL by default), with quality filters to exclude bots and brand-new accounts.
GET/hyperliquid/fills$0.024Returns a wallet's individual fills (fill-level executions), newest first by default, with realized PnL, fees, and direction (crossed=true marks a taker fill that took liquidity).
GET/exchange/price$0.01Returns the real-time ticker for a trading pair.
GET/fund/detail$0.01Returns a crypto VC fund's full profile: description, jurisdiction, portfolio count, social links, and team members with roles.
GET/prediction-market/kalshi/prices$0.024Price time series for a Kalshi market with daily or hourly OHLC data, or latest price from recent trades.
GET/prediction-market/matching/daily$0.024Returns daily volume and open interest comparison for a specific Polymarket <> Kalshi matched pair.
GET/prediction-market/polymarket/orderbooks$0.024Historical orderbook snapshots for a Polymarket token.
GET/web/fetch$0.01Fetches a web page and converts it to clean, LLM-friendly markdown.
GET/market/listing$0.012Returns historical exchange listing and delisting events.
POST/onchain/sql/jobs$0.024Run a read-only ClickHouse SQL query as a durable background job — for queries too heavy for the 30s synchronous window.
GET/hyperliquid/trades/aggregate$0.024Returns a wallet's closed trades rolled up server-side into one row per group — so the P&L calendar, per-symbol / direction / size attribution, and the realized equity curve are one call each instead of paging the whole trade history.
POST/onchain/sql$0.024Run a read-only ClickHouse SQL query against on-chain data (joins, aggregations, custom windows) with a 30s timeout.
GET/market/futures$0.012Returns futures market data across all tracked tokens in a single ranked snapshot.
GET/search/prediction-market$0.024Browse and search prediction markets across all supported platforms.
GET/search/airdrop/activities$0.01Lists airdrop activities with pagination.
GET/prediction-market/polymarket/price-ohlcv/{condition_id}$0.024OHLCV candlestick data for charting a Polymarket market — open, high, low, close, volume per candle.
GET/token/holders$0.012Returns top token holders for a contract address.
GET/wallet/protocols$0.012Returns all DeFi protocol positions for a wallet — lending, staking, LP, and farming with token breakdowns and USD values.
GET/wallet/transfers$0.012Returns ERC-20/SPL token transfers with token identity, USD value, and flow direction (in/out).
GET/search/token$0.01Resolves an exact token ticker symbol to likely contract address candidates on supported chains.
GET/prediction-market/polymarket/positions$0.024Given a specific wallet address, returns that wallet's open positions on Polymarket markets.
GET/market/price-indicator$0.012Returns a technical indicator for a trading pair on a given exchange and interval.
GET/exchange/depth$0.01Returns order book bid/ask levels with computed stats.
GET/market/price$0.012Returns historical price data points for a token over a specified time range.
GET/prediction-market/polymarket/open-interest$0.024Daily open interest time series showing total value locked in a Polymarket market.
GET/heatscore/detail$0.024Returns one project signal card.
GET/search/project$0.01Searches crypto projects by keyword.
GET/token/transfer-stats$0.012Aggregate transfer-activity summary for a token over a window — total transfers, unique senders/receivers, total amount, first/last activity, and an optional daily series (include=series).
GET/project/detail$0.012Returns a crypto project's profile with selectable sub-resources: overview (description, chains, exchanges), token_info (price, market cap, supply, all-time high/low dates), tokenomics, funding, team, contracts, social, tge_status.
GET/onchain/yield/ranking$0.012List individual DeFi yield pools ranked by APY or TVL.
GET/news/detail$0.01Returns the full content of a single news article by its ID (returned as id in feed and search results).
GET/market/exchange-flow/exchanges$0.012Returns Surf's curated exchange filters for exchange-flow metrics: upstream aggregate filters plus 20 high-coverage individual exchanges.
GET/prediction-market/polymarket/leaderboard$0.024Returns a ranked leaderboard of Polymarket traders by realized PnL, volume, or trade count.
GET/search/fundraising$0.01Searches source-backed fundraising and token-sale events, or returns the latest fundraising timeline when q is omitted.
GET/project/defi/ranking$0.012Returns a DeFi protocol leaderboard (e.g. Aave, Uniswap, Lido) ranked by TVL, fees, revenue, or users.
GET/exchange/perp$0.01Returns a perpetual futures snapshot for a trading pair: funding rate, open interest, mark/index price.
GET/exchange/candles$0.01Returns persisted OHLCV candles for a covered Bithumb, Upbit, HashKey, bitFlyer, Coinone, or Korbit spot market.
GET/search/fund$0.01Searches funds by keyword.
GET/dex/token/price$0.01Returns DEX-pool-weighted OHLCV bars (timestamp, open, high, low, close, volume_usd) for a single token identified by chain + address.
GET/hyperliquid/account$0.024Returns a wallet's full portfolio across perps, spot, vaults, and staking in one call, with a perp+vault equity roll-up (total_value_usd is the total-equity figure a dashboard header should show, vs the perp-only equity on /performance and /positions).
GET/exchange/funding-history$0.01Returns historical funding rate records for a perpetual contract.
GET/prediction-market/polymarket/events$0.024Returns Polymarket events with nested markets, filtered by event_slug, which is REQUIRED.
GET/prediction-market/polymarket/volumes$0.024Aggregate trading volume (USD) and trade count as a time series.

Call the provider directly and settle x402 per request.

Quickstart · x402 flow

1 · Call without payment. The service replies 402

bash
curl -i https://x402.monid.ai/v1/run \  -H "Content-Type: application/json" \  -d '{"provider": "surf", "endpoint": "/onchain/bridge/ranking", "input": {}}'
Response
HTTP/1.1 402 Payment Required{ "x402Version": 2,  "accepts": [{ "scheme": "exact", "network": "eip155:143",  "asset": "USDC", "maxAmountRequired": "0.012" }] }

2 · Sign the payment with your agent wallet and retry

bash
curl https://x402.monid.ai/v1/run \  -H "X-PAYMENT: <base64 payment payload signed by your EOA>" \  -H "Content-Type: application/json" \  -d '{"provider": "surf", "endpoint": "/onchain/bridge/ranking", "input": {}}'
Response
HTTP/1.1 200 OK

Any EOA on Monad can pay.

Any APIs or tools listed are provided for discovery purposes only and do not constitute an endorsement or recommendation by the Monad Foundation.