AgentFeed MCP
AgentFeed provides an MCP server for AI agents to access crypto market data, including live liquidations, funding rates, and wallet holdings. It supports Solana pre-trade checks, OFAC sanctions screening, and language tasks like OCR and translation. Payment is handled via x402 protocol in USDC across multiple chains, with optional prepaid keys for bots.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://x402.ochinimus.app/mcpWhat its tools do
102 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (102)
get_liq_pulseget_perpget_funding_pulseget_liquidation_leadersget_cascade_scanget_liq_heatmapget_squeeze_scoreget_cascade_forecast_freeget_forecast_recordget_cascade_forecastget_open_interestget_funding_rateget_sol_priceget_btc_priceget_fear_greedget_market_snapshotget_wallet_holdingsget_token_metadataget_recent_liquidationsget_cascade_alertget_forecast_questionget_liquidation_statsget_last_liquidationget_positioningget_trade_contextget_token_riskget_exit_methodget_liq_historyget_cascade_historyget_venue_liq_shareget_funding_extremesget_funding_radarget_market_stateget_macro_calendarget_tradfi_radarget_equity_24hget_oi_spike_scanget_basisget_volatilityget_funding_historyget_top_moversget_orderbook_imbalanceget_orderbook_wallsget_token_holdersget_wallet_activityget_priority_feesget_jito_tipsget_sol_networkget_peg_deviationget_peg_sessionsget_peg_universeget_exit_quoteget_eth_priceget_base_gasget_base_balanceget_honeypot_checkget_base_launchesget_hl_whalesget_web_markdownget_pdf_markdownget_sec_filingsget_insider_tradesget_sec_8kget_tradfi_perpsget_fx_ratesget_liq_feedget_spotget_signal_boardget_coin_signalget_sanctions_checkget_email_verifyget_domainget_papersget_paperget_wikiget_qrget_hashget_timeget_convertget_sol_token_checkget_sol_token_flowget_sol_holder_clustersget_ocrget_summarizeget_extractget_translateget_classifyget_injection_checkget_transcribeget_morning_briefget_move_alertget_anomaly_flagget_x402_lintget_x402_testget_cascade_backtestget_claim_checkget_site_signalsget_pkg_checkget_tx_precheckget_company_checkget_rwa_yieldspricing
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Retrieve live crypto liquidation data across major exchanges
- Check Solana wallet holdings and token metadata
- Screen assets for OFAC sanctions compliance
- Perform language tasks like translation and summarization
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- agentfeed 2.10.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 102 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
102 advertised
get_liq_pulse — Liquidation pulse
Use when an agent needs to know what is being liquidated right now. Returns the last 60 minutes across every USDT perp we record: total USD, long/short split, prints and the top 5 symbols. If our recording is stale it answers 503 and is never billed. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_liq_pulse payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_liq_pulse",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_liq_pulse",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_perp — Perp snapshot
Use when an agent needs one perp market in a single call. Returns Hyperliquid funding and open interest (with 1h/24h change from our 5-minute sampler) and 24h liquidations with long/short split and biggest print from our own tape. A symbol nothing lists answers 400 and a failed read answers 503; neither is ever billed. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_perp payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_perp",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_perp",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_funding_pulse — Funding pulse
Use when an agent needs the most extreme funding rates right now. Returns the 5 largest absolute annualised rates across the Hyperliquid perps above a liquidity floor, each with 8h rate, open interest and 24h price move. One call, not a full screen. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_funding_pulse payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_funding_pulse",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_funding_pulse",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_liquidation_leaders — Liquidation leaderboard
What is blowing up RIGHT NOW: top symbols ranked by liquidation USD across every USDT perp we record on Bybit, OKX and Binance. Per symbol: total liquidated, long vs short split, biggest single print, venue count, dominant side. The fastest read on where leverage is being flushed. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"description": "top N symbols, 1-50, default 10"
},
"window_min": {
"type": "number",
"description": "lookback minutes, 5-1440, default 60"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_liquidation_leaders payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_liquidation_leaders",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_liquidation_leaders",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_cascade_scan — Full universe cascade scan
Liquidation cascade scan across EVERY USDT perp we record at once, not just the majors: symbol, side liquidated, USD total, prints, duration, severity. Computed from our own multi-venue liquidation tape. Costs 0.05 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"window": {
"type": "number",
"description": "lookback window seconds, 30-300, default 90"
},
"min_usd": {
"type": "number",
"description": "min summed USD, default 50000"
},
"min_events": {
"type": "number",
"description": "min prints to qualify, default 4"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_cascade_scan payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_cascade_scan",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_cascade_scan",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_liq_heatmap — Liquidation heatmap
Liquidation heatmap by PRICE LEVEL: where leverage actually got flushed in the last N hours — USD, prints and long/short split per price zone, with the hottest zone flagged. Built from real liquidation prints, not entry-price estimates. BTC, ETH, SOL, HYPE or any other USDT perp on our multi-venue liquidation tape. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hours": {
"type": "number",
"description": "lookback 1-168, default 24"
},
"symbol": {
"type": "string",
"description": "BTC, ETH, SOL, HYPE or any USDT perp e.g. BTCUSDT (default SOLUSDT)"
},
"buckets": {
"type": "number",
"description": "price buckets 5-50, default 20"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_liq_heatmap payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_liq_heatmap",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_liq_heatmap",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_squeeze_score — Squeeze score
Short squeeze score and long flush score, 0-100, for any Hyperliquid perp. Composite of Hyperliquid funding (35), whale crowding (25: the net-long share of the top 250 Hyperliquid accounts in the coin, not retail), the 24h open-interest build from our own 5-minute sampler (20) and liquidation skew from our own tape (20). One number for whether a trade is crowded and about to hurt someone. A symbol nothing lists answers 400; while the open-interest record is under 24 hours deep, or Hyperliquid or the whale snapshot is unavailable, it answers 503; both are never billed. A listed coin none of the top 250 accounts holds returns 200 with a decline naming the missing input. Costs 0.1 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_squeeze_score payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_squeeze_score",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_squeeze_score",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_cascade_forecast_free — Free cascade forecast
FREE taster: the full-quality liquidation forecast for SOL, no delay and nothing withheld. Use it to check the calibration before paying for coverage of the other ~345 symbols. Free.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_cascade_forecast_free payload",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_cascade_forecast_free",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_forecast_record — Forecast track record
FREE: the live track record of this miner. Every forecast was written down BEFORE its 15-minute window opened and settled afterwards from the exchange public feed, and the raw rows are returned alongside the score so you can recompute it yourself rather than take it on trust. Returns settled count, base rate, Brier skill against climatology, coverage, calibration error and a reliability curve. A backtest is a claim about the past that its author also chose how to compute; this is not that. Free.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"rows": {
"type": "number",
"description": "how many raw rows to return, max 500, default 50"
},
"symbol": {
"type": "string",
"description": "restrict the record to one symbol"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_forecast_record payload",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_forecast_record",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_cascade_forecast — Liquidation cascade forecast
Liquidation forecast, FORWARD-LOOKING and not a description of what already happened. Returns the probability that a symbol will liquidate more in the NEXT 15 minutes than its own 90th-percentile 15-minute window. Calibrated on our whole multi-venue liquidation tape, over 6 million liquidations, refit every 6 hours; no exchange publishes that history, so it cannot be rebuilt. Every answer carries the exact question, the threshold in USD, the window it read, the number of historical occurrences behind the number, and instructions for settling it yourself from the public feed. When a state has too little history the tool DECLINES rather than guessing, and says why. The settled record is free at /api/forecast-record. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "SOL, BTC, ETH or any USDT perp e.g. SXTUSDT (default SOL)"
},
"symbols": {
"type": "string",
"description": "comma separated for a batch, max 20, e.g. SOL,BTC,ETH"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_cascade_forecast payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_cascade_forecast",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_cascade_forecast",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_open_interest — Open interest
Open interest for ANY Hyperliquid perp: OI in base units and in USD with the mark price, and its 1h and 24h change from our own 5-minute sampler (null until that record reaches back so far). /api/positioning adds the whale net-long share for SOL and BTC. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_open_interest payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_open_interest",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_open_interest",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_funding_rate — Perp funding rate
Funding rate for any Hyperliquid perp: raw rate, interval hours, 8h equivalent, annualised rate, next funding time and mark price. Without a symbol, SOL and BTC from Hyperliquid with open interest. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. ETHUSDT, ONDOUSDT (omit for SOL and BTC from Hyperliquid)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_funding_rate payload (without symbol: {sol, btc} from Hyperliquid; with symbol: {symbol, venues: {hyperliquid}}); a real captured example is free at https://x402.ochinimus.app/api/sample/get_funding_rate",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_funding_rate",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sol_price — SOL spot price
Live SOL/USD spot price read on-chain: the median of the two deepest SOL/USDC pools on Solana (Orca Whirlpool, Raydium CLMM). confidence is null: a pool publishes none. Costs 0.001 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sol_price payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sol_price",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sol_price",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_btc_price — BTC spot price
Live BTC/USD spot price read on-chain: the median of three Uniswap V3 reads on Base and Ethereum (cbBTC/USDC, cbBTC and WBTC through WETH/USDC). confidence is null: a pool publishes none. Costs 0.001 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_btc_price payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_btc_price",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_btc_price",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_fear_greed — Fear and Greed index
Crypto Fear & Greed index (0-100) with classification. Free.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_fear_greed payload",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_fear_greed",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_market_snapshot — Market snapshot
SOL+BTC prices, funding rates, and Fear & Greed in one call. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_market_snapshot payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_market_snapshot",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_market_snapshot",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_wallet_holdings — Solana wallet holdings
Solana wallet holdings: native SOL with its USD value at AgentFeed's own on-chain SOL price, SPL tokens with mint, symbol and amount (no token prices), NFT count (Helius DAS balances). Costs 0.008 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet"
],
"properties": {
"wallet": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "Solana wallet address (base58)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_wallet_holdings payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_wallet_holdings",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_wallet_holdings",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_token_metadata — SPL token metadata
SPL token metadata: name, symbol, URI, decimals, supply, mint and freeze authority, mutability. Read from the mint account and its metadata account. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mint"
],
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "SPL token mint address (base58)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_token_metadata payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_token_metadata",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_token_metadata",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_recent_liquidations — Recent liquidations
Recent perp liquidations across Bybit (complete unthrottled tape), OKX and Binance: timestamp, long/short, size, price, USD value. Any USDT perp we record, not just majors. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"description": "max rows, 1-100, default 25"
},
"scope": {
"enum": [
"core",
"all"
],
"type": "string",
"description": "core = the 5 majors (default), all = every recorded USDT perp"
},
"symbol": {
"type": "string",
"description": "SOL, BTC, ETH, XRP, DOGE, or any USDT perp e.g. SXTUSDT (omit for majors)"
},
"min_usd": {
"type": "number",
"description": "only prints >= this USD size"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_recent_liquidations payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_recent_liquidations",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_recent_liquidations",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_cascade_alert — Liquidation cascade alert
Liquidation cascade detector for the 5 majors (SOL, BTC, ETH, XRP, DOGE): returns cascades active NOW - clustered same-side liquidations with symbol, side, USD total, prints, duration, severity (minor/major/extreme). Empty cascades array = no cascade in window. For every USDT perp we record across 3 exchanges, use get_cascade_scan. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"window": {
"type": "number",
"description": "lookback window seconds, 30-300, default 90"
},
"min_usd": {
"type": "number",
"description": "min summed USD, default 50000"
},
"min_events": {
"type": "number",
"description": "min prints to qualify, default 4"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_cascade_alert payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_cascade_alert",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_cascade_alert",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_forecast_question — Forecast question spec
FREE: the exact question the forecast answers, machine readable, plus how to settle it yourself from the public exchange feed and the full list of covered symbols. Read this before building on the forecast. Free.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_forecast_question payload",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_forecast_question",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_liquidation_stats — Liquidation stats
Liquidation aggregates for the 5 majors (SOL, BTC, ETH, XRP, DOGE): 1h and 24h totals, longs vs shorts USD split, biggest print, broken out per exchange. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_liquidation_stats payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_liquidation_stats",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_liquidation_stats",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_last_liquidation — Last liquidation
FREE taster: last liquidation for SOL, BTC, ETH, XRP and DOGE (15-min delayed). Real-time via get_recent_liquidations. Free.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_last_liquidation payload",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_last_liquidation",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_positioning — SOL and BTC positioning
SOL+BTC positioning on Hyperliquid: open interest with 1h/24h change and the top 250 accounts' net-long share (whale crowding). Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_positioning payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_positioning",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_positioning",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_trade_context — Trade context
Full market state in one call: SOL+BTC prices, funding, Fear & Greed, positioning (open interest and whale net-long share), and liquidation stats. The complete pre-trade picture. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_trade_context payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_trade_context",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_trade_context",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_token_risk — Token rug check
SPL token rug-risk signals: mint/freeze authority status (revoked = safer), top-1/top-10 holder concentration, and risk flags. Not a honeypot/LP-lock checker. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mint"
],
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "SPL token mint address (base58)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_token_risk payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_token_risk",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_token_risk",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_exit_method — Exit liquidity method
FREE: how overhang measures exit liquidity on lending collateral, and the counts behind every paid answer - computed from the tape at request time, nothing hardcoded. Returns what is measured (the protocol's own live-refetched mark vs realisable value from sell-direction quotes at real clip sizes), the corroboration rule in plain terms (a terminal verdict needs six consecutive agreeing floor observations from the symbol's own tape; one sample is never enough; a contradicted floor buys a fresh probe rather than writing a hole), the full status vocabulary including why a router refusal and an empty book are different facts, the size-matched control design and its results, the gated sweep and row counts, covered symbols and markets, and the measured cadence. Read this before paying for get_exit_quote, and to check the claim rather than trust it. Free.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_exit_method payload",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_exit_method",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_liq_history — Liquidation history
Liquidation history, time-bucketed: total, long and short USD, prints and biggest print per bucket, for any USDT perp or the whole recorded universe, up to 7 days back. Bybit is the only complete liq tape in crypto and no exchange publishes history of it. Costs 0.05 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hours": {
"type": "number",
"description": "lookback 1-168, default 24"
},
"scope": {
"enum": [
"symbol",
"all"
],
"type": "string",
"description": "all = whole universe"
},
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
},
"bucket_min": {
"type": "number",
"description": "bucket minutes 5-1440, default 60"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_liq_history payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_liq_history",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_liq_history",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_cascade_history — Cascade history
Liquidation cascade history: past clustered same-side flush events reconstructed from our own tape, with start and end, prints, USD total and peak print, up to 72h back. /api/cascade tells you what is happening NOW; this tells you what already happened. Costs 0.03 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"gap_s": {
"type": "number",
"description": "max gap seconds within an event, default 60"
},
"hours": {
"type": "number",
"description": "1-72, default 24"
},
"scope": {
"enum": [
"symbol",
"all"
],
"type": "string",
"description": "symbol = just this symbol (default), all = every recorded USDT perp"
},
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
},
"min_usd": {
"type": "number",
"description": "min event USD, default 100k (250k for scope=all)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_cascade_history payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_cascade_history",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_cascade_history",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_venue_liq_share — Liquidations by venue
Liquidations by exchange: per-venue liquidation share across Bybit, OKX and Binance with long/short split and biggest print, for any symbol or the whole recorded universe. Which venue is flushing whom. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hours": {
"type": "number",
"description": "1-168, default 24"
},
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default all)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_venue_liq_share payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_venue_liq_share",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_venue_liq_share",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_funding_extremes — Funding extremes
Funding rate extremes across every Hyperliquid perp above a liquidity floor: the most positive and most negative funding with annualized %, 24h price move and open interest. The most crowded trades in the market — crowded shorts are squeeze candidates. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"description": "top N each side, 1-25, default 10"
},
"min_turnover_usd": {
"type": "number",
"description": "24h volume floor in USD, default 1M"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_funding_extremes payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_funding_extremes",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_funding_extremes",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_funding_radar — Funding radar
Funding radar over every Hyperliquid perp: 337 on 13 Oct 2026, 178 on the main dex and 159 on the HIP-3 dexes (stocks, indices, commodities, FX). Per perp: the current funding at its 8h equivalent, its 30-day z-score against its own settled history, the dex and asset class, and a flag on any |z| of 2 or more, most extreme first. By default it returns the perps with $10M and up of open interest; min_oi_usd changes that and 0 returns them all. Precomputed every 5 minutes with as_of; a snapshot older than 15 minutes answers 503 and is never billed. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"top": {
"type": "number",
"description": "perps returned, most extreme first, 1-100, default 20"
},
"min_oi_usd": {
"type": "number",
"description": "minimum open interest in USD: default 10000000 ($10M); 0 returns every perp the radar tracks"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_funding_radar payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_funding_radar",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_funding_radar",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_market_state — Market state
Market state for BTC, ETH, SOL or HYPE in one call: spot and the perp's basis against the Hyperliquid oracle, realized vol 7d and 30d, funding with its 30-day z-score, open interest and its changes, the top Hyperliquid accounts' net-long share, liquidations 1h and 24h by side, Fear and Greed, the next FOMC or CPI release, and flags with stated thresholds. Every part carries its source and as-of time; a part we do not hold is null with a reason. When nothing of the market itself could be built it answers 503 and is never billed. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "BTC (default), ETH, SOL or HYPE"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_market_state payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_market_state",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_market_state",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_macro_calendar — Macro calendar
FOMC, CPI, NFP and PCE calendar for traders: the next Fed rate decisions and the CPI, nonfarm payrolls and PCE release dates with UTC times converted from New York time (DST-aware), each with its official Fed, BLS or BEA source URL and the time we verified it. Read daily from the agencies' own pages and never entered by hand; data verified more than 35 days ago answers 503 and is never charged. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"type": "number",
"description": "days ahead, 1-400, default 90"
},
"type": {
"type": "string",
"description": "comma list of FOMC, CPI, NFP, PCE (default all)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_macro_calendar payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_macro_calendar",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_macro_calendar",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_tradfi_radar — TradFi perps radar
Stock perps, S&P 500, Nasdaq, gold and oil perps ranked by funding rate: every stock, index, commodity and FX perp on the Hyperliquid HIP-3 dexes (trade[XYZ], Paragon, Markets by Kinetiq, Entropy), with funding at its 8h equivalent, a 30-day funding z-score, open interest and its 24h change, mark minus oracle basis and 24h volume. Filter by asset class. Precomputed every 5 minutes; stale data answers 503. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"top": {
"type": "number",
"description": "markets returned, 1-200, default 25"
},
"class": {
"type": "string",
"description": "comma list of stock, index, commodity, fx, rates, pre_ipo, crypto_index, other (default all)"
},
"min_oi_usd": {
"type": "number",
"description": "minimum open interest in USD (default 0)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_tradfi_radar payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_tradfi_radar",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_tradfi_radar",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_equity_24h — Equity 24/7 price
Weekend price for US stocks: an indicative 24/7 price for a stock or index (TSLA, NVDA, S&P 500, Nasdaq) from stock perps on Hyperliquid and our tokenized stocks DEX price, with the last regular-session price, its time and source, the implied gap in %, each source's liquidity and the session (open, pre, after, overnight, weekend). Indicative, never an exchange quote; 503 when no source has liquidity. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "US stock or index ticker as the venues list it, e.g. TSLA, NVDA, SP500, XYZ100"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_equity_24h payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_equity_24h",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_equity_24h",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_oi_spike_scan — Open interest spikes
Open interest spikes across every Hyperliquid perp: coins whose open interest moved abnormally in the last hour against their own previous day, with the 1h, 4h and 24h change (in coin units, so a price move does not count), a spike z-score, the price move and funding. Read from our own 5-minute sampler: it answers 503 and is never billed until that record is 24 hours deep. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"description": "top N, 1-25, default 10"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_oi_spike_scan payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_oi_spike_scan",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_oi_spike_scan",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_basis — Perp basis vs oracle
Perp basis for any Hyperliquid perp: its mark price against Hyperliquid's oracle price (the validators' weighted median of spot venues), as a premium or discount in %, with a contango or backwardation read and the funding context. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_basis payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_basis",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_basis",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_volatility — Realized volatility
Realized volatility for any Hyperliquid perp: 7-day and 30-day annualized from daily candles, plus today's range in %. A position-sizing input. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_volatility payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_volatility",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_volatility",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_funding_history — Funding history
Funding rate history for any Hyperliquid perp, up to 200 hourly settlements: the average rate, its annualized %, the share of intervals that were positive, and the raw series. What the carry has actually been. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"description": "hourly settlements, 1-200, default 30"
},
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_funding_history payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_funding_history",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_funding_history",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_top_movers — Top movers
Top gainers and losers over 24h across every Hyperliquid perp above a liquidity floor, each with its funding rate attached. The "what moved" screener. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"description": "top N each side, 1-25, default 10"
},
"min_turnover_usd": {
"type": "number",
"description": "24h volume floor in USD, default 1M"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_top_movers payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_top_movers",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_top_movers",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_orderbook_imbalance — Orderbook imbalance
Orderbook imbalance for any Hyperliquid perp: resting bid and ask liquidity in USD within ±N bps of mid, the ratio between the two sides, and a skew read. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"bps": {
"type": "number",
"description": "window ±bps around mid, 5-500, default 50"
},
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_orderbook_imbalance payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_orderbook_imbalance",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_orderbook_imbalance",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_orderbook_walls — Orderbook walls
Orderbook walls for any Hyperliquid perp: the largest resting orders on each side of the book, with USD size and distance from mid. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"top": {
"type": "number",
"description": "walls per side, 1-15, default 5"
},
"symbol": {
"type": "string",
"description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_orderbook_walls payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_orderbook_walls",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_orderbook_walls",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_token_holders — Top token holders
Top holders of any SPL token: per-account share with top-1, top-5 and top-10 concentration for a Solana mint. A deeper cut than the summary in /api/token-risk. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mint"
],
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "SPL token mint address (base58)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_token_holders payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_token_holders",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_token_holders",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_wallet_activity — Solana wallet activity
Solana wallet activity: recent transactions for any address, each with the wallet's SOL and token balance changes, the fee, failures and the programs invoked. Read from the chain and summarised by us. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet"
],
"properties": {
"limit": {
"type": "number",
"description": "tx count, 1-25, default 10"
},
"wallet": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "Solana wallet address (base58)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_wallet_activity payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_wallet_activity",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_wallet_activity",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_priority_fees — Solana priority fees
Solana priority fees right now: percentiles from min to max of the per-slot minimum fee paid on the busiest SOL/USDC pools over the last ~150 slots, in micro-lamports per compute unit, with a recommended level. For bots that need their transactions to land. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_priority_fees payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_priority_fees",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_priority_fees",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_jito_tips — Jito tip floor
Jito tips sampled on-chain: p25 to p99 in SOL of the newest transfers into Jito's tip accounts, what landed bundles actually paid, refreshed every 15 minutes (the age is in the answer), with a landing recommendation. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_jito_tips payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_jito_tips",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_jito_tips",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sol_network — Solana network health
Solana network health: recent average TPS, the current slot, the current epoch and epoch progress in %. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sol_network payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sol_network",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sol_network",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_peg_deviation — Tokenized stock peg
Tokenized stock peg deviation on Solana: the on-chain DEX price of a tokenized US equity versus the underlying's last real trade, in bps, with 24h stats split into market-open and off-hours. Sampled every 5 minutes by our own collector; the token price is read on-chain. latest.reference is null: the underlying's reference price is not returned (its source does not allow redistribution), only the deviation computed from it. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"symbol"
],
"properties": {
"hours": {
"type": "number",
"description": "lookback 1-168, default 24"
},
"symbol": {
"type": "string",
"description": "Tokenized equity symbol e.g. CRCLx, MSTRx, COINx"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_peg_deviation payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_peg_deviation",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_peg_deviation",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_peg_sessions — Peg by session
Tokenized stock peg by trading session: deviation broken out across open, premarket, afterhours, overnight and weekend — mean, p95, max bps and median liquidity each, with the worst off-hours window flagged. Market-open acts as the control. Costs 0.03 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"symbol"
],
"properties": {
"days": {
"type": "number",
"description": "lookback 1-30, default 7"
},
"symbol": {
"type": "string",
"description": "Tokenized equity symbol e.g. CRCLx, MSTRx, COINx"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_peg_sessions payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_peg_sessions",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_peg_sessions",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_peg_universe — Tokenized stock rankings
Tokenized stocks ranked by off-hours peg risk: every tokenized US equity we track, with p95 and max deviation bps, market-open deviation as the control, and median liquidity. Dead pools are excluded rather than reported as perfect pegs. Costs 0.05 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"type": "number",
"description": "lookback 1-30, default 7"
},
"min_liquidity_usd": {
"type": "number",
"description": "filter out thinner pools"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_peg_universe payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_peg_universe",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_peg_universe",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_exit_quote — Collateral exit liquidity
EXIT LIQUIDITY on seized collateral: what a liquidator ACTUALLY realises selling a Kamino reserve into live routing, versus the oracle price the protocol marks it at. Returns max_exitable_usd (largest clip whose liquidator margin is still positive, found by bisection, with its resolution width), the exitable fraction, the conservative bound at the 2% penalty floor, and for the nearest clip actually probed: realised USD, haircut bps and liquidator margin bps. Distinguishes a router that REFUSES to quote a token (permissioning, not illiquidity) from a book with no route (a real liquidity finding) - they are different facts and were one status until this split. A terminal verdict requires six consecutive agreeing observations from the symbol's own tape, so a single bad quote cannot produce a finding; withheld verdicts fall back to the last corroborated measurement with its age rather than returning null. Zero bad debt today does not disprove any of this - it means nobody has been forced to test it at size. Method, corroboration rules and row counts are free via get_exit_method. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "reserve symbol e.g. SPYx, cbBTC, FWDI, CRCLx (get_exit_method lists all covered)"
},
"size_usd": {
"type": "number",
"description": "clip size in USD you would need to exit; the nearest MEASURED clip is returned, never interpolated"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_exit_quote payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_exit_quote",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_exit_quote",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_eth_price — ETH spot price
ETH spot price in USD, read on-chain from the two deepest WETH/USDC Uniswap V3 pools, on Ethereum and on Base. Returns their median plus each pool's own price, so a caller can see the spread between chains. Computed from chain state; no exchange feed. Costs 0.001 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_eth_price payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_eth_price",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_eth_price",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_base_gas — Base gas price
Base gas price (chain 8453) in BOTH gwei and wei, with base fee, priority fee and block number when the node supplies them. Both units are returned because a caller asking in wei and a caller asking in gwei are asking the same question. Served from keyless public RPC with three-node fallback, so there is no API key to rotate or expire. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_base_gas payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_base_gas",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_base_gas",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_base_balance — Base wallet balance
ERC20 and native ETH wallet balance on Base or Ethereum mainnet, for a 0x address or an ENS name. decimals() and symbol() are read from the contract at request time rather than assumed, because assuming 18 reports a USDC balance a trillion times too large. ENS is resolved through two independent resolvers and the answer is used only when they agree, so a wrong address can never produce a confident balance for the wrong wallet. An unsupported chain is refused rather than silently answered from the wrong one. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"chain": {
"type": "string",
"description": "base (default) or ethereum"
},
"token": {
"type": "string",
"description": "ERC20 contract address, or a known ticker: USDC, WETH, DAI, CBBTC, USDBC, CBETH, AERO, EURC. Omit for the native ETH balance"
},
"address": {
"type": "string",
"description": "0x address (40 hex) or an ENS name ending .eth"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_base_balance payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_base_balance",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_base_balance",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_honeypot_check — Honeypot check
Use when an agent needs to know whether a token on Base, BNB Chain or Ethereum can be sold before it buys. Returns a verdict from our own buy-then-sell simulation on the token's deepest pool, with the buy and sell tax measured. Also: whether a wallet transfer works, bytecode flags (mintable, blacklist, proxy, pausable, owner), where simulation and bytecode disagree, and the block. Uniswap, Aerodrome and PancakeSwap pools. No pool found is a finding; RPC failure answers 503. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token"
],
"properties": {
"chain": {
"type": "string",
"description": "base (default: Uniswap V2/V3/V4, Aerodrome), bsc (PancakeSwap V2/V3) or ethereum (Uniswap V2/V3)"
},
"token": {
"type": "string",
"description": "token contract address, 0x followed by 40 hex characters"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_honeypot_check payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_honeypot_check",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_honeypot_check",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_base_launches — Base launches
Use when an agent needs the newest token launches on Base. Returns pools created on Base in the last 24 hours on Uniswap V4, V3, V2 and Aerodrome, newest first, with launchpad, liquidity and volume. Each carries its pair, creation time, launchpad named from the V4 hook (Zora, Clanker, Doppler, Flaunch), quote-side liquidity, 24h volume and swaps, and our honeypot simulation for the busiest. Read from Base logs every minute; a snapshot older than 5 minutes answers 503. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"maximum": 100,
"minimum": 1,
"description": "launches returned, newest first, 1-100, default 20"
},
"min_liq_usd": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "minimum quote-side liquidity (ETH, WETH or USDC held) in USD, default 1000; 0 lists every launch"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_base_launches payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_base_launches",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_base_launches",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_hl_whales — Hyperliquid whales
Use when an agent needs to know how the biggest Hyperliquid traders are positioned. Returns the open perp positions of the largest Hyperliquid accounts aggregated per coin: net long or short USD, account counts, size-weighted entries, notional-weighted distance to liquidation, notional within 10% of liquidation and uPnL. With coin=BTC: whale liquidation levels in 5% price bands and the largest positions. Refreshed every 5 minutes; stale data answers 503. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"top": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "coins (or positions with coin=) returned, 1-50, default 20"
},
"coin": {
"type": "string",
"description": "one Hyperliquid perp, e.g. BTC, ETH, SOL, HYPE: adds liquidation bands and the top positions"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_hl_whales payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_hl_whales",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_hl_whales",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_web_markdown — Web page to markdown
Use when an agent needs the readable text of a web page as markdown. Returns the main content of the one URL you pass as clean markdown (Mozilla Readability, then turndown), with title, final URL, fetch time and word count. http or https on ports 80 and 443, 5 MB, 10 s; robots.txt honoured and private addresses refused. A blocked or unreachable URL is never charged. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the page to convert: an absolute http or https URL"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_web_markdown payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_web_markdown",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_web_markdown",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_pdf_markdown — PDF to markdown
Use when an agent needs the text of a PDF as markdown. Returns the text of the one PDF URL you pass, page by page as markdown, with title, page count and word count. http or https, 10 MB, 10 s; robots.txt honoured and private addresses refused. A file that is not a PDF, a PDF with no text layer (a scan), or an unreachable URL, is never charged. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the PDF to convert: an absolute http or https URL"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_pdf_markdown payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_pdf_markdown",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_pdf_markdown",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sec_filings — SEC filings
Use when an agent needs a US company's latest SEC filings. Returns the most recent EDGAR filings for a ticker, optionally one form type (10-K, 10-Q, 8-K, 4, S-1, 13F-HR), with filing date, report date, accession number, description, 8-K item codes and links to the document and the filing index. Source: SEC EDGAR public filings. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ticker"
],
"properties": {
"form": {
"type": "string",
"description": "one EDGAR form type, e.g. 10-K, 10-Q, 8-K, 4"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "filings returned, 1-50, default 10"
},
"ticker": {
"type": "string",
"description": "a US-listed ticker, e.g. AAPL, MSFT, BRK-B"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sec_filings payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sec_filings",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sec_filings",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_insider_trades — Insider trades
Use when an agent needs what a company's insiders bought and sold. Returns one row per transaction from the company's recent SEC Form 4 filings: insider, role, transaction code and meaning, shares, price, value, shares owned after and date, plus open-market buy and sale totals for the window. Source: SEC EDGAR Form 4 filings. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ticker"
],
"properties": {
"days": {
"type": "integer",
"maximum": 180,
"minimum": 1,
"description": "look-back window in days, 1-180, default 30"
},
"ticker": {
"type": "string",
"description": "a US-listed ticker, e.g. NVDA, TSLA"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_insider_trades payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_insider_trades",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_insider_trades",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sec_8k — SEC 8-K events
Use when an agent needs the material events US companies disclosed in the last hours. Returns the 8-K filings filed across the market in the window, with company, CIK, filing time, accession number, the 8-K item codes and titles (e.g. 2.02 results, 5.02 officer changes, 1.01 agreements) and a count per item. Source: SEC EDGAR current filings. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hours": {
"type": "integer",
"maximum": 72,
"minimum": 1,
"description": "look-back window in hours, 1-72, default 24"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sec_8k payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sec_8k",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sec_8k",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_tradfi_perps — Tradfi perps (HIP-3)
Use when an agent needs a 24/7 price for a stock, index, commodity or currency outside market hours. Returns Hyperliquid HIP-3 perp markets: oracle and mark price, premium, hourly and 8h funding, open interest, 24h change and the dex. With symbol (TSLA, GOLD, EUR or xyz:TSLA): every live market for it. Without: the whole list. Prices are each market's own HIP-3 oracle and mark. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "a HIP-3 ticker such as TSLA, GOLD, EUR, or a dex-qualified market such as xyz:TSLA"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_tradfi_perps payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_tradfi_perps",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_tradfi_perps",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_fx_rates — FX reference rates
Use when an agent needs official daily exchange rates. Returns the ECB euro foreign exchange reference rates for about 30 currencies, as published or as crosses for another base, plus Hyperliquid HIP-3 FX and commodity marks. The ECB rates are available free of charge on the ECB's website; they are for information only, not for transactions. Costs 0.002 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"base": {
"type": "string",
"description": "base currency, 3 letters, default EUR; other bases are crosses computed from the ECB rates"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_fx_rates payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_fx_rates",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_fx_rates",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_liq_feed — Liquidation pressure feed
Use when an agent needs liquidation pressure as it happens. Returns 5-second buckets per symbol of long and short USD liquidated across venues, the dominant side and pressure against the symbol's own baseline, from a gap-free cursor. Calls are paced per caller: one every 5 seconds (one bucket) for an x402 payer or a prepaid pack key, one every 10 seconds for a pass key, except while an answer says has_more; a call that comes too early is a 429 with Retry-After and is never billed. Costs 0.001 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"next": {
"type": "string",
"description": "the `next` value of the previous answer; send it back unchanged to continue with no gap and no repeat"
},
"since": {
"type": "number",
"description": "first call only: start time in milliseconds since the epoch, up to 24 h back; omit to begin 2 minutes back"
},
"symbols": {
"type": "string",
"description": "comma list of up to 20 symbols, e.g. BTC,ETH,SOL or BTCUSDT,ETHUSDT (default SOL,BTC,ETH,XRP,DOGE)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_liq_feed payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_liq_feed",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_liq_feed",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_spot — Spot price
Use when an agent needs a spot price without choosing a venue. Returns the on-chain DEX price for SOL, BTC or ETH, the median of deep USDC pools on Solana, Ethereum and Base read from chain state, and the pools that served it. Any other symbol answers 400 with the supported list and is never billed. Costs 0.001 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"symbol": {
"type": "string",
"description": "SOL, BTC or ETH (default SOL). Any other symbol answers 400 with the supported list"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_spot payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_spot",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_spot",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_signal_board — Perp signal board
Signal board for trading bots: the Hyperliquid perp market in one table, ranked by open interest in USD (30 coins by default, up to 60, or the coins you list). Per coin: mark, 1h and 24h price change, funding (hourly and annualised), open interest in USD with its 1h and 24h change, liquidations in the last hour by side with a z-score against the coin's own last 7 days, the whale net position and tilt of the top 250 Hyperliquid accounts, and flags: crowded_long (funding_ann_pct >= 30 and oi_chg_24h_pct >= 5), crowded_short (funding_ann_pct <= -10 and oi_chg_24h_pct >= 5), squeeze_risk (crowded_short and (chg_1h_pct >= 1 or liq_1h_short_usd >= 2 x liq_1h_long_usd with liq_1h_short_usd >= 50000)), liq_spike (liq_z >= 3 and liq_1h_long_usd + liq_1h_short_usd >= 50000). Poll every 1-5 minutes: one call is the whole market structure, answered from our own caches, each source named with its as_of. A source past its staleness limit answers 503 and is never billed. Costs 0.01 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"n": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "coins returned, ranked by open interest in USD, 1-60, default 30"
},
"coins": {
"type": "string",
"description": "comma list of Hyperliquid coins instead of the top n, at most 20, e.g. BTC,ETH,SOL"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_signal_board payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_signal_board",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_signal_board",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_coin_signal — Coin signal
Signal for one Hyperliquid perp, for trading bots. Everything on the signal board for the coin (price changes, funding, open interest, liquidations with their z-score, whale net position and tilt, flags) plus the 15-minute liquidation cascade probability from our forecast model, the nearest liquidation cluster above and below price from the 24 h liquidation heatmap, and the top 3 whale positions (side, size, entry, liquidation price). BTC, ETH, SOL, HYPE or any other Hyperliquid perp. Poll every 1-5 minutes. An unknown coin answers 400 with the supported list and a stale source answers 503; neither is billed. Costs 0.004 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"coin"
],
"properties": {
"coin": {
"type": "string",
"pattern": "^[A-Za-z0-9-]+$",
"maxLength": 30,
"minLength": 1,
"description": "a Hyperliquid perp, e.g. BTC, ETH, SOL, HYPE, kPEPE"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_coin_signal payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_coin_signal",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_coin_signal",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sanctions_check — OFAC wallet screen
Use when an agent needs to screen a crypto wallet before paying or being paid. Returns an exact match of a Bitcoin, Ethereum, Tron, Solana or other address against the OFAC SDN list, with entry, program and list date. No match is not a clearance. Costs 0.008 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"pattern": "^\\s*[A-Za-z0-9:]{14,120}\\s*$",
"maxLength": 130,
"minLength": 14,
"description": "a crypto address of any family: bitcoin, ethereum, tron, solana, xrp, litecoin and so on"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sanctions_check payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sanctions_check",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sanctions_check",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_email_verify — Email verification
Use when an agent needs to know whether an email address can plausibly receive mail. Returns syntax, MX, disposable-domain, role-account and free-provider checks with a deliverable_likely, risky or undeliverable verdict and its reasons. No SMTP probe. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "the address to check, up to 254 characters"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_email_verify payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_email_verify",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_email_verify",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_domain — Domain DNS and TLS
Use when an agent needs the basic facts about a domain. Returns its DNS A, AAAA, MX, NS and TXT records and the live TLS certificate: issuer, alternative names, validity dates and days to expiry. Public hosts only; no registrar data. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"minLength": 3,
"description": "a hostname such as example.com (no URL, no IP address)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_domain payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_domain",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_domain",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_papers — Paper search
Use when an agent needs scholarly papers on a topic. Returns OpenAlex works (CC0 data) for a search: title, year, DOI, authors, venue, citation count and open-access link, up to 25, optionally from a given year. Cached 24 hours. Costs 0.015 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "the search text, up to 200 characters"
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "papers returned, 1-25, default 10"
},
"year_from": {
"type": "integer",
"maximum": 9999,
"minimum": 1000,
"description": "earliest publication year, e.g. 2022"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_papers payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_papers",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_papers",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_paper — Paper by DOI
Use when an agent needs the paper behind a DOI. Returns title, year, authors, venue, citation count, open-access URL and the abstract where OpenAlex holds it (CC0 data). The DOI goes in the path as written, slash included: /api/paper/10.1038/nature14539. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"doi"
],
"properties": {
"doi": {
"type": "string",
"pattern": "10\\.\\d{4,9}(?:\\/|%2[Ff])\\S+",
"maxLength": 300,
"minLength": 7,
"description": "a DOI such as 10.1038/nature14539, sent in the path as written (its slash as %2F also works)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_paper payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_paper",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_paper",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_wiki — Wikipedia summary
Use when an agent needs a reliable plain-text summary of a topic. Returns the Wikipedia summary and lead section for a page title in any language, with the CC BY-SA 4.0 licence, the article URL and the authors link. Cached 24 hours. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title"
],
"properties": {
"lang": {
"type": "string",
"description": "Wikipedia language code, default en"
},
"title": {
"type": "string",
"description": "the article title, e.g. Solana (blockchain platform)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_wiki payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_wiki",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_wiki",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_qr — QR code
Use when an agent needs a QR code for a link, address or payment string. Returns an SVG or PNG (base64 and data URI) at error-correction level M, scaled for scanning. Input up to 2 KB; over that is a 400, never billed. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"data"
],
"properties": {
"data": {
"type": "string",
"description": "the text to encode, up to 2,048 bytes"
},
"format": {
"enum": [
"svg",
"png"
],
"type": "string",
"description": "svg (default) or png"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_qr payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_qr",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_qr",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_hash — Hash
Use when an agent needs a hash it should not compute itself. Returns SHA-256, Keccak-256 (the Ethereum hash) or BLAKE2b-512 of UTF-8 text or hex bytes, as hex and 0x-hex. Input up to 2 KB; over that is a 400, never billed. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"alg",
"data"
],
"properties": {
"as": {
"enum": [
"utf8",
"hex"
],
"type": "string",
"description": "how to read data: utf8 (default) or hex bytes"
},
"alg": {
"enum": [
"sha256",
"keccak256",
"blake2b"
],
"type": "string",
"description": "the hash"
},
"data": {
"type": "string",
"description": "the input, up to 2,048 bytes"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_hash payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_hash",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_hash",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_time — Time zone conversion
Use when an agent needs an exact time conversion with the right daylight-saving rules. Returns an ISO time or epoch in any IANA time zone: local time with offset, weekday, abbreviation, DST flag and epoch. Defaults to now in UTC. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"at": {
"type": "string",
"description": "ISO 8601 with Z or an offset, or epoch seconds or milliseconds; default now"
},
"tz": {
"type": "string",
"description": "IANA zone such as Europe/Chisinau or America/New_York, default UTC"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_time payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_time",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_time",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_convert — Unit conversion
Use when an agent needs an exact unit conversion. Returns the value converted between units of length, mass, volume, time, data, speed, area, pressure, energy or temperature, to 12 significant digits. Mixing categories is a 400, never billed. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"value",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "unit, e.g. km, lb, MB, F"
},
"from": {
"type": "string",
"description": "unit, e.g. mi, kg, GiB, C"
},
"value": {
"type": "string",
"description": "a plain number"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_convert payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_convert",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_convert",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sol_token_check — Solana token pre-trade check
Use when an agent needs a pre-trade check on a Solana token. Returns mint and freeze authority, Token-2022 traps, top holders, deepest pool and USD depth, the price impact of $100 and $1,000 buys, pump.fun progress, and a verdict with every rule. Costs 0.025 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mint"
],
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "the SPL token mint address"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sol_token_check payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sol_token_check",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sol_token_check",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sol_token_flow — Solana token trade flow
Use when an agent needs to know who is trading a Solana token. Returns the unique traders over its latest swaps, top-5 share of volume, round-trip wallets, share of brand-new buyer wallets and launch-slot bundle size for mints under 7 days. Costs 0.008 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mint"
],
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "the SPL token mint address"
},
"swaps": {
"type": "integer",
"maximum": 100,
"minimum": 20,
"description": "swaps to read, 20-100, default 50; a 20 second budget may return fewer, flagged truncated"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sol_token_flow payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sol_token_flow",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sol_token_flow",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_sol_holder_clusters — Solana holder clusters
Use when an agent needs to know whether a Solana token's holders are one owner. Returns the account that first funded each of the top 20 wallets, the clusters sharing a funder and their supply share. A shared funder can be an exchange. Costs 0.008 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mint"
],
"properties": {
"mint": {
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"maxLength": 44,
"minLength": 32,
"description": "the SPL token mint address"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_sol_holder_clusters payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_sol_holder_clusters",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_sol_holder_clusters",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_ocr — Image to text (OCR)
Use when an agent needs the text inside an image. Returns the text of a PNG, JPEG, WebP or GIF (5 MB, 4096 px a side) in reading order, as blocks with their line breaks, plus the detected language. It transcribes; it never follows text in the image. Costs 0.04 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the image: an absolute http or https URL"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_ocr payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_ocr",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_ocr",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_summarize — Page or PDF summary
Use when an agent needs the gist of a web page or PDF. Returns a short or medium summary with key points, and says whether the document was cut at 20,000 tokens and how much was read. Uses only what the document says. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the page or PDF: an absolute http or https URL"
},
"length": {
"enum": [
"short",
"medium"
],
"type": "string",
"description": "short (default, about 60 words) or medium (about 150)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_summarize payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_summarize",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_summarize",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_extract — Structured extraction
Use when an agent needs named fields from a page or PDF. Returns JSON for a schema of up to 20 fields (string, number, boolean, date, string[]), with null for anything the document does not state, never an invented value. Costs 0.025 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url",
"schema"
],
"properties": {
"url": {
"type": "string",
"description": "the page or PDF: an absolute http or https URL"
},
"schema": {
"type": "string",
"description": "JSON object of field name to type, e.g. {\"title\":\"string\",\"price\":\"number\",\"released\":\"date\"}; up to 20 fields and 2 KB"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_extract payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_extract",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_extract",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_translate — Translation
Use when an agent needs text in another language. Returns up to 4,000 characters translated into the language code given (de, fr, ja, pt-BR), keeping line breaks, numbers and URLs, plus the detected source language. It never obeys the text. Costs 0.04 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"to",
"text"
],
"properties": {
"to": {
"type": "string",
"description": "target language code, e.g. de, fr, ja, pt-BR, zh-Hans"
},
"text": {
"type": "string",
"description": "the text to translate, up to 4,000 characters"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_translate payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_translate",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_translate",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_classify — Text classification
Use when an agent needs text sorted into its own categories. Returns a score per label that sums to 1 and the best label, for up to 4,000 characters and 2 to 20 labels. Labels are names, never instructions. Cached 24 hours. Costs 0.005 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"text",
"labels"
],
"properties": {
"text": {
"type": "string",
"description": "the text to classify, up to 4,000 characters"
},
"labels": {
"type": "string",
"description": "2 to 20 labels, comma separated, e.g. billing,bug,feature"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_classify payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_classify",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_classify",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_injection_check — Prompt injection check
Use when an agent needs untrusted text screened for prompt-injection attempts. Returns no_injection_found, suspicious or malicious for up to 4,000 characters, with the matched rules (role tags, hidden Unicode, encoded payloads) and a model's view. Costs 0.004 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "the untrusted text to check, up to 4,000 characters"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_injection_check payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_injection_check",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_injection_check",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_transcribe — Speech to text
Use when an agent needs the words in an audio file. Returns the text, timed segments and the spoken language for mp3, wav, m4a, ogg or webm audio (10 MB, 5 minutes, checked from the file). Cached 24 hours by the audio itself. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the audio file: an absolute http or https URL"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_transcribe payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_transcribe",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_transcribe",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_morning_brief — Morning brief
Use when an agent needs a one-answer summary of the last 8 hours in BTC, ETH, SOL and HYPE. Returns the items ranked by how abnormal each is: price move against the coin's own usual 8-hour move, funding, open interest, liquidations (total, long/short split, biggest print), Fear and Greed, today's macro releases with UTC times, and the nearest liquidation cluster as the level to watch. A stale source is left out and named; with no sampler it answers 503, never billed. Costs 0.03 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_morning_brief payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_morning_brief",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_morning_brief",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_move_alert — Move alert
Use when an agent needs to know which Hyperliquid perps moved unusually. Returns each coin whose 5-minute, 1-hour or 4-hour price move, or 1-hour open-interest change, is past its own measured tail (tiers from the coin's own history, sample size printed), labelled event-driven when a scheduled FOMC, CPI, NFP or PCE release explains it. An empty list is a valid answer. Stale inputs answer 503, never billed. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_move_alert payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_move_alert",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_move_alert",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_anomaly_flag — Anomaly flag
Use when an agent needs one check for what is abnormal across Hyperliquid perps right now. Returns funding, liquidation and open-interest anomalies in one ranked list, using the thresholds of /api/market-state, or nothing abnormal with what was checked. If a source is stale and nothing else was found it answers 503 rather than an all-clear, and is never billed. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_anomaly_flag payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_anomaly_flag",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_anomaly_flag",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_x402_lint — x402 challenge lint
Use when an agent needs to check an x402 endpoint's payment challenge before paying it. Returns a verdict, a 0 to 100 score and 32 checks, paywall bypass included. Never pays. An unreachable endpoint answers 503 and a refused URL 400, neither charged. Costs 0.05 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the x402 endpoint to check, URL-encoded: http or https, a public host, port 80 or 443"
},
"method": {
"enum": [
"GET",
"POST"
],
"type": "string",
"description": "HTTP method to check, default GET (a POST is sent with an empty body)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_x402_lint payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_x402_lint",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_x402_lint",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_x402_test — x402 paid test
Use when an agent needs proof that an x402 endpoint takes a real payment. Returns PASS, FAIL or INCONCLUSIVE with the receipt after paying it once from our own wallet, up to $0.05, in Base or Solana USDC. A 503 or 404 is not charged. Costs 1 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the x402 endpoint to pay once, URL-encoded: https only, a public host, port 443; the paid request goes to exactly this URL"
},
"method": {
"enum": [
"GET",
"POST"
],
"type": "string",
"description": "HTTP method to pay with, default GET (a POST is sent with an empty body)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_x402_test payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_x402_test",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_x402_test",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_cascade_backtest — Cascade backtest
Use when an agent needs what price did after past liquidation cascades. Returns a symbol's events with 15 m, 1 h, 4 h and 24 h forward returns, n, mean, median, hit rate, a bootstrap interval and a random-time baseline. Not charged on 400, 404 or 503. Costs 0.5 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"side": {
"enum": [
"long",
"short",
"both"
],
"type": "string",
"description": "which liquidations count: long, short or both (default both)"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "events listed, largest first, 1 to 100, default 20; the statistics always use every event"
},
"symbol": {
"type": "string",
"description": "BTC, ETH, SOL or any symbol the backtest covers (default SOLUSDT); a symbol it does not cover answers 400 with the list that works"
},
"min_usd": {
"type": "number",
"maximum": 1000000000,
"minimum": 10000,
"description": "USD liquidated inside the window, 10,000 to 1,000,000,000, default 100,000"
},
"window_min": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "rolling window in minutes, 1 to 60, default 5"
},
"cooldown_min": {
"type": "integer",
"maximum": 1440,
"minimum": 15,
"description": "minutes without a qualifying window before the next event can start, 15 to 1,440, default 60"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_cascade_backtest payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_cascade_backtest",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_cascade_backtest",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_claim_check — Claim check
Use when an agent needs a short claim checked against sources. Returns SUPPORTED, CONTRADICTED or INSUFFICIENT, with every supporting line quoted word for word from a filing, Wikipedia article or URL. No readable source answers 404 or 503, not charged. Costs 0.15 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"claim"
],
"properties": {
"urls": {
"type": "string",
"description": "up to 3 https URLs of pages that should settle it, comma separated or repeat the parameter; omit them and the service reads one SEC filing when the claim carries an explicit ticker such as $AAPL, else the Wikipedia articles the claim names"
},
"claim": {
"type": "string",
"description": "the claim to check: one statement of fact, 10 to 300 characters"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_claim_check payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_claim_check",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_claim_check",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_site_signals — Site signals
Use when an agent needs the technical facts of one website. Returns its TLS certificate, DNS records, a security-header grade over 8 checks, tech stack and social links. A bad URL (400) or unreachable site (503) is not charged. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "the site: an absolute https URL on the standard port, for example https://www.example.com/ (a host name, not an IP address)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_site_signals payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_site_signals",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_site_signals",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_pkg_check — Package check
Use when an agent needs to know if an npm or PyPI version has a published advisory. Returns flagged (any OSV advisory for that exact version), highest severity, advisories, release, scripts, downloads, name-squat flags. 404 or 503: not charged. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"ecosystem"
],
"properties": {
"name": {
"type": "string",
"description": "package name: an npm name (optionally @scope/name) or a PyPI project name"
},
"version": {
"type": "string",
"description": "version to check, for example 4.17.21 (default: the latest published version)"
},
"ecosystem": {
"type": "string",
"description": "npm or pypi"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_pkg_check payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_pkg_check",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_pkg_check",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_tx_precheck — Transaction precheck
Use when an agent needs to see what a Solana or Base transaction does before signing it. Returns simulated balance changes, programs or contracts, approvals, new accounts, token-risk reads and warnings. 503 if it cannot simulate: not charged. Costs 0.05 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain"
],
"properties": {
"to": {
"type": "string",
"maxLength": 42,
"description": "chain=base: the 0x address the transaction calls"
},
"tx": {
"type": "string",
"maxLength": 1644,
"description": "chain=solana: the transaction as base64, legacy or version 0, signed or unsigned, at most 1232 bytes"
},
"data": {
"type": "string",
"maxLength": 20002,
"description": "chain=base: calldata as 0x hex, at most 20000 hex characters (default 0x)"
},
"from": {
"type": "string",
"maxLength": 42,
"description": "chain=base: the sender, a 0x address (default: a placeholder sender that holds nothing)"
},
"chain": {
"enum": [
"solana",
"base"
],
"type": "string",
"description": "the chain of the transaction: solana or base"
},
"value": {
"type": "string",
"maxLength": 80,
"description": "chain=base: wei to send, decimal or 0x hex (default 0)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_tx_precheck payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_tx_precheck",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_tx_precheck",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_company_check — Company check
Use when an agent needs to check a US-listed company. Returns a verdict line and the SEC facts behind it: going-concern language, delisting-notice 8-Ks, overdue reports, insider Form 4 direction. EDGAR down (503) or a foreign filer (404) is not charged. Costs 0.25 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "the company: a US-listed ticker such as AAPL, the company name as it is filed, or its website such as example.com (EDGAR rarely maps a website, so a website is matched by its domain to the company name and the answer says how)"
},
"site": {
"type": "string",
"description": "optional: the company website to read with the site check (TLS, DNS, security headers), such as www.example.com; without it the site is the website given as q, or the one EDGAR lists"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_company_check payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_company_check",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_company_check",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_rwa_yields — RWA yields
Use when an agent needs the realized 7-day and 30-day yield of tokenized treasury and credit products, computed from issuer on-chain prices. Returns NAV, yields, contract and method. A failed read answers 503, not charged. Costs 0.02 USDC per call (x402, USDC on Solana, Base, Polygon, Arbitrum or Arc).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"product": {
"type": "string",
"description": "one product id (usdy, ousg, ustb, usyc, syrupusdc); omit it for every product"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "the get_rwa_yields payload; a real captured example is free at https://x402.ochinimus.app/api/sample/get_rwa_yields",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "get_rwa_yields",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}pricing — Price list
Use when an agent needs the price list before calling anything. Returns every agentfeed tool with its USDC price and description. Free.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tool",
"data"
],
"properties": {
"data": {
"type": "object",
"description": "tools: the full price list",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tool": {
"type": "string",
"const": "pricing",
"description": "the tool that produced this payload"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1443 ms
- 95th percentile latency
- 1443 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1443 ms · metadata changed · 102 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http agentfeed-mcp https://x402.ochinimus.app/mcpCodex
codex mcp add agentfeed-mcp --url https://x402.ochinimus.app/mcpCursor
{
"mcpServers": {
"agentfeed-mcp": {
"url": "https://x402.ochinimus.app/mcp"
}
}
}Cline
{
"mcpServers": {
"agentfeed-mcp": {
"type": "streamableHttp",
"url": "https://x402.ochinimus.app/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"agentfeed-mcp": {
"type": "http",
"url": "https://x402.ochinimus.app/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http agentfeed-mcp https://x402.ochinimus.app/mcpClaude Desktop
https://x402.ochinimus.app/mcpWindsurf
{
"mcpServers": {
"agentfeed-mcp": {
"serverUrl": "https://x402.ochinimus.app/mcp"
}
}
}Let your agent find its tools
Find servers like AgentFeed MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.