funding-mcp

@usenami/funding-mcp

MCP server for multi-venue perpetual + HIP-3 market data — 20+ exchanges including Binance, Bybit, OKX, Hyperliquid, Aster, Lighter, and Hyperliquid HIP-3 sub-DEXes (stocks, metals, oil, forex, indices, pre-IPO synthetics) that CoinGecko / CMC / Coinglass don't aggregate.

Gives any MCP-capable AI agent a named, schema'd surface for funding, liquidity, positioning, flow, basis, and RWA data — backed by Usenami's live API. Pairs with @usenami/signer-mcp for keyless execution.

Tools

| Tool | What it does | Cost | |------|--------------|------| | funding_screener | Current cross-venue funding rates (preview) | Free | | funding_arb | Ranked cross-exchange funding-arb candidates | ~$0.003 | | funding_signal | Decision-ready funding-arb signal: net-of-fees + breakeven + depth-sized max notional + liquidity flag | ~$0.025 | | funding_spread | Per-symbol funding spread across venues | ~$0.001 | | funding_history | Historical funding rates (backtesting) | ~$0.005 | | orderbook_slippage | Multi-venue execution cost / slippage | ~$0.005 | | open_interest | Current OI for ticker on venue | ~$0.001 | | oi_delta | OI change over a lookback window | ~$0.003 | | volume_24h | 24h perp volume for ticker on venue | ~$0.001 | | volume_anomalies | Anomalous volume spikes across venues | ~$0.003 | | oracle_families | Oracle-family / basis-risk map | ~$0.001 | | rwa_coverage | HIP-3 RWA coverage (stocks/metals/oil) | ~$0.001 |

Paid tools settle in USDC on Base via the x402 protocol. Set X402_PRIVATE_KEY (a Base wallet holding USDC) and the paid tools auto-pay and return data; without it they return the x402 payment requirements so any x402-capable client can pay and retry. funding_screener is free and needs no wallet.

Note: funding_arb is a naive scan (excludes fees, latency, and execution timing) — treat it as a candidate list, not trade advice.

Install

{
  "mcpServers": {
    "usenami-funding": {
      "command": "npx",
      "args": ["-y", "@usenami/funding-mcp"]
    }
  }
}

Optional env: USENAMI_API_BASE (default https://api.usenami.io); X402_PRIVATE_KEY (Base wallet 0x… with USDC — enables built-in auto-pay for the paid tools).

Support

Hit a problem or want data we don't cover yet? Report issues / request data: support@usenami.io · Partnerships: business@usenami.io · Telegram: @USnami.

Local dev

npm install
npm run build
npm start

MIT · usenami.io