Composable Ask Omni

One question, several bounded Omni products, one evidence-backed answer.

This recipe mirrors an agent marketplace bundle without hiding the underlying services. Independent x402 and MCP calls run in parallel, each returns its own schema, freshness, price, and settlement receipt, and synthesis happens only after the evidence has been validated.

At a glance

Brief: 0.016 USDC Published roundup + moving events + mark-anchored Market Risk.
Deep: 0.029 USDC Brief plus Carry, Market Snapshot, and the all-level Liquidation Map.
Visual: 0.039 USDC Deep plus a verified liquidation-level screenshot.

Why It Matters

What traders and researchers should take away

The published roundup supplies a citable morning thesis while live products expose what changed after publication.
Liquidations, margin stress, funding, carry, candles, and news are separate evidence—not one opaque model answer.
Every tier has an exact maximum cost before the buyer authorizes payment.

How it works

What the product uses behind the scenes

Use get_premarket_roundup, get_market_moving_events, and get_market_risk_context as the required parallel group.
For the deep tier, add get_market_carry plus the HTTP Market Snapshot and Liquidation Map routes as optional no-retry enrichment.
For the visual tier, add one verified PNG screenshot. Resolve a noncanonical mention first for an additional 0.001 USDC.
The source SDK exports createAskOmniBundlePlan and includes examples/agents/ask-omni-bundle.ts with deterministic demo and explicitly gated paid modes.
Synthesis must cite schemas, canonical publication URLs, freshness, missing optional evidence, and settlement receipts.

Notes

Things to know

This is a recipe of separately settled products, not a single opaque endpoint or subscription.
The pre-market product returns a bounded public excerpt and canonical link, not raw HTML or the full article body.
Research never places an order. Broker preview or execution requires a separate client, authority, budget, and approval.

Choose a bounded tier

Start with the smallest evidence set that can answer the question.

Brief: compare the published morning thesis with current catalysts and Market Risk; stop if a required product fails.
Deep: add funding/carry, candles and price structure, every bounded published liquidation level, and margin stress.
Visual: add one verified liquidation-level PNG when the consuming agent or user benefits from chart evidence.
Entity resolution is conditional, runs before the parallel research group, and is charged only for ambiguous mentions.

Run the SDK example from scratch

The default command is deterministic and makes no request, payment, or order.

bash

git clone https://github.com/InTheta/omni-universe-sdks.git
cd omni-universe-sdks/packages/typescript
npm ci
npm run verify
npm run example:ask-omni:demo

# Paid Base Sepolia only after funding a dedicated low-balance wallet:
RUN_PAID_ASK_OMNI_BUNDLE=yes EVM_PRIVATE_KEY=0x... OMNI_ASK_OMNI_TIER=deep npm run example:ask-omni

The example rejects unknown tiers/symbols and a bundle ceiling above 0.050 USDC.
Paid mode is opt-in and defaults to Base Sepolia; Base mainnet requires its own explicit network gate.
Required calls run concurrently; optional enrichment is omitted without retry when unavailable.

Copyable agent workflow

Give a tool-using model a clear budget, evidence contract, and execution boundary.

“Build a deep Ask Omni report for BTC. Spend no more than 0.029 USDC. In parallel buy the latest Omni pre-market roundup, current market-moving events, Market Risk, Carry, Market Snapshot, and the all-level Liquidation Map.”
“Require the documented schemas and fresh current data. Omit failed optional enrichment without retry and report the missing evidence.”
“Compare the published thesis with live catalysts, funding direction, margin stress, nearest liquidation levels, and price structure. Cite the canonical roundup URL and settlement receipts.”
“Return BULLISH, BEARISH, MIXED, or INSUFFICIENT_EVIDENCE with contradictions and invalidation conditions. Do not preview or place an order.”

References

Implementation references

TypeScript Ask Omni bundle guide
https://github.com/InTheta/omni-universe-sdks/blob/main/packages/typescript/docs/ask-omni-bundles.md
Defines the tier calculator, exact service menu, environment gates, and runnable example.
Omni x402 API reference
omni-terminal/docs/X402_API_REFERENCE.md
Defines the paid HTTP and MCP contracts used by the bundle.