Contract
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"condition_id"
]
},
{
"required": [
"category"
]
},
{
"required": [
"direction"
]
},
{
"required": [
"whale_tier"
]
},
{
"required": [
"from"
]
},
{
"required": [
"to"
]
}
],
"required": [],
"properties": {
"to": {
"type": "string",
"minLength": 1,
"description": "End time as Unix seconds or date string (only for view=trades)."
},
"from": {
"type": "string",
"minLength": 1,
"description": "Start time as Unix seconds or date string (only for view=trades)."
},
"view": {
"enum": [
"positioning",
"trades"
],
"type": "string",
"default": "positioning",
"description": "positioning = aggregate smart wallet direction per market; trades = individual $10K+ trades with wallet metadata. Defaults to \"positioning\"."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Results per page. Defaults to 20."
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"default": "desc",
"description": "Sort direction. Defaults to \"desc\"."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset. Defaults to 0."
},
"sort_by": {
"enum": [
"smart_wallets_involved",
"smart_buy_volume_usd",
"smart_sell_volume_usd",
"amount_usd",
"block_time"
],
"type": "string",
"default": "smart_wallets_involved",
"description": "Sort field. Defaults to \"smart_wallets_involved\"."
},
"category": {
"enum": [
"crypto",
"culture",
"economics",
"financials",
"politics",
"stem",
"sports"
],
"type": "string",
"description": "Filter by category."
},
"direction": {
"enum": [
"bullish",
"bearish",
"neutral"
],
"type": "string",
"description": "Filter by net smart money direction (only for view=positioning)."
},
"whale_tier": {
"enum": [
"whale",
"large",
"mega"
],
"type": "string",
"description": "Trade size tier filter (only for view=trades)."
},
"condition_id": {
"type": "string",
"minLength": 1,
"description": "Filter to a specific market (omit to browse all)."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"price": {
"type": "number",
"description": "Execution price for the traded outcome, 0-1. Trades view only."
},
"shares": {
"type": "number",
"description": "Trade size in outcome shares. Trades view only."
},
"tx_hash": {
"type": "string",
"description": "The trade's on-chain transaction hash. Trades view only."
},
"category": {
"type": "string",
"description": "Market category (e.g. 'Politics'). Only observed on the positioning view."
},
"question": {
"type": "string",
"description": "The market's question text. Present on both views."
},
"amount_usd": {
"type": "number",
"description": "Trade size in USD. Trades view only."
},
"block_time": {
"type": "number",
"description": "Unix seconds the trade was mined. Trades view only."
},
"whale_tier": {
"type": "string",
"description": "Size tier for this trade ('whale' observed). Trades view only."
},
"condition_id": {
"type": "string",
"description": "The Polymarket market's on-chain condition id. Present on both views."
},
"maker_address": {
"type": "string",
"description": "Pseudonymous on-chain wallet address for the trade's maker side. Trades view only."
},
"outcome_label": {
"type": "string",
"description": "The outcome traded (e.g. 'Yes'/'No'/'Up'). Trades view only."
},
"taker_address": {
"type": "string",
"description": "Pseudonymous on-chain wallet address for the trade's taker side. Trades view only."
},
"smart_conviction": {
"type": "number",
"description": "A conviction score, observed roughly 2.4-6 across the real positioning fixture. Positioning view only; exact scale is not documented upstream."
},
"smart_wallets_no": {
"type": "number",
"description": "Count of tracked smart wallets positioned No. Positioning view only."
},
"smart_wallets_yes": {
"type": "number",
"description": "Count of tracked smart wallets positioned Yes. Positioning view only."
},
"net_smart_direction": {
"type": "string",
"description": "'BULLISH' or 'BEARISH' on the real fixture observed (input also accepts 'neutral' as a filter value). Only present on the positioning view."
},
"smart_buy_volume_usd": {
"type": "number",
"description": "Aggregate smart-wallet buy volume in USD. Positioning view only."
},
"smart_sell_volume_usd": {
"type": "number",
"description": "Aggregate smart-wallet sell volume in USD. Positioning view only."
},
"smart_wallets_involved": {
"type": "number",
"description": "Total tracked smart wallets on either side. Positioning view only."
}
},
"additionalProperties": true
},
"description": "One entry per market (view=positioning) or per trade (view=trades)."
},
"meta": {
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"cached": {
"type": "boolean"
},
"offset": {
"type": "number"
}
},
"additionalProperties": true
}
},
"description": "The smart-money result set, as returned at routing.responseResultPath ($.output). Item shape depends on the requested `view`: positioning fields (net direction, wallet counts, buy/sell volume) for view=positioning, trade fields (price, size, wallet addresses) for view=trades.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.03276 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 23, 2026