hood_basis_snapshot
Hood Basis Snapshot
Current basis (premium/discount) snapshot for all Robinhood Chain
tokenized stocks. Per ticker: chainlink_px (on-chain price), ref_last
(NASDAQ), basis_bps (+ = token trades at a premium), overnight_bps (move
vs last close) and the oracle_paused flag.
无需输入参数。
hood_basis_history
Hood Basis History
Minute-level basis history for one ticker (newest first). Example
tickers: NVDA, TSLA, SPY. limit max 5000.
输入参数limitticker必填
hood_gaps_summary
Overnight/Weekend Gap Summary
Overnight and weekend premium/discount statistics for all tickers:
average, min/max and latest value (bps). Tokens trade 24/5, so this
measures the drift that builds up while NASDAQ is closed.
输入参数days
hood_gaps_live
Live Off-Hours Gaps
Live view of the current off-hours session: which tickers trade at the
largest premium/discount vs their last close. Returns 'regular' when the
stock market is open.
无需输入参数。
hood_gap_sessions
Gap Session History
Session-by-session gap history for one ticker (each overnight/weekend
session is a separate row).
输入参数daysticker必填
hood_feeds
Feed & Token Registry
Registry of all tokenized stock and crypto feeds tracked on Robinhood
Chain (Chainlink proxy + token contract addresses).
无需输入参数。
reddit_alpha_signals
Reddit Alpha Signals
Ticker alpha signals extracted from Reddit (novelty, mention velocity
and cross-sub spread components). signal_type: ticker_alpha|crowded_trade|
event_mispricing|squeeze_watch. tickers is comma-separated (NVDA,TSLA).
输入参数limittickersmin_alphasignal_type
reddit_market_regime
Reddit Market Regime
Current market regime inferred from Reddit chatter (e.g.
mag7_only_rally, risk_on_call_chase) + confidence + flags to watch.
无需输入参数。
hood_attention
Hood Attention x Basis
Reddit attention/alpha score joined with live basis for Hood tokenized
stocks: which tokens have social interest AND an on-chain premium/discount
at the same time. Fan-out (same post, many tickers) is deduplicated.
输入参数min_alpha
hood_pools
Uniswap Pool Prices
Tracked Uniswap (Hood) pools: pool price per token, liquidity (USD) and
deviation vs the Chainlink oracle price (dev_bps). Refreshed every 5 min.
无需输入参数。
oracle_deviation
Oracle vs Pool Deviation
Chainlink-vs-Uniswap pool price deviation (bps, sorted by absolute
value). status: ok (<100), warning (100-500), alert (>500). Large
deviations are normal in low-liquidity pools — check liquidity_usd.
输入参数min_abs_bps
stable_risk
Stablecoin Depeg Risk
Deviation of USDG and other stablecoins from $1 parity (depeg risk, bps).
无需输入参数。
market_events
Market News Events
Machine-readable news events (crypto + stocks). symbols is
comma-separated (NVDA,BTC), event_type: listing|hack|regulation|earnings|
etf|partnership|macro|liquidation|stablecoin|general. importance 0-100.
输入参数limitsymbolsevent_typemin_importance
token_flows
Whale Token Flows
Large on-chain token transfers (whale flows): 32 stock tokens + USDG
above the USD threshold. direction: mint|burn|transfer. Mints/burns show
the tokenized stock supply changing (issuance/redemption).
输入参数hourslimittickermin_usddirection
flow_summary
Flow Summary by Ticker
Whale-flow summary per ticker: transfer count, total USD volume,
mint/burn USD (supply change) and the largest transfer.
输入参数hours
hood_stock_research
Hood Stock Research
Daily deep-research report: score (0-100), rating (strong_buy|buy|hold|
avoid) and 4 analysis columns per Hood tokenized stock: thesis, dated
catalysts (off_hours-flagged, verified earnings dates), financials (PE
ttm/fwd, growth, margins, valuation_label: expensive|fair|discount|n_a),
competitors (peers + positioning) and news_summary ([+]/[=]/[-] tagged).
The api_data field carries exact API numbers (price, market cap, 1d/7d/30d,
52w, target mean/hi/lo, analyst rec counts) — use it when precision
matters. With ticker: one card + live basis join; empty: full report.
输入参数ticker
hood_off_hours_catalysts
Off-Hours Catalysts
Dated catalysts that can move token prices while NASDAQ is closed
(nights/weekends) — flattened from all research cards, sorted by date.
For agents watching overnight gap and weekend risk.
无需输入参数。
hood_earnings_risk
Hood Earnings Risk
Earnings risk for Hood tokenized stocks (weekly earnings radar): per
ticker report_date/time, days_to_earnings, implied_move_pct (option-implied
expected move), beat_probability (0-100), PEAD status + live basis join.
Earnings released while NASDAQ is closed make the token gap — watch small
days_to_earnings for off-hours risk management. tickers: CSV filter
(empty = full Hood universe).
输入参数tickersdays_ahead
hood_sector_rotation
Hood Sector Rotation
Sector rotation context for Hood tokenized stocks (API-only tracker
refreshed every 3h): market regime (risk_on|risk_off|mixed), an 11-SPDR
sector score/label/flow board and a per-ticker join — sector score
(0-100), label (inflow|interest|neutral|outflow_leaning|outflow), flow
trend, theme matches + live basis. Answers where money is rotating and
whether your token's sector is in inflow or outflow. tickers: CSV filter
(empty = full Hood universe).
输入参数tickers
service_status
Service Status / Data Freshness
Trust status of the Otto data layer: per-feed freshness (age_sec/stale),
24h tick coverage, NASDAQ reference availability and oracle-pause count.
Call before making trading decisions — status: ok|degraded|down.
无需输入参数。
chain_stats
Chain Deploy Stats
Robinhood Chain deployment statistics: daily deploy/token counts, top
deployers, total contract/verified counts (Ottoscan analytics).
输入参数days
chain_deployments
Contract Deployments (Ottoscan)
New contract deployments on Robinhood Chain (Ottoscan; full history
since genesis). tokens_only=True returns only new token contracts.
输入参数limittokens_onlyverified_only
gap_trade_signals
Gap Trade Signals
Deterministic signals for the gap-trader strategy: per Hood ticker the
overnight gap it currently carries (bps), a signal (long_at_open |
avoid_or_reduce | none), 14-day gap statistics, the hit rate of pre-open
gap direction vs open direction (hit_rate_14d) and risk flags
(oracle_paused, stale, low_liquidity, earnings_within_48h). Signals are
NOT orders — sizing and approval belong to the user. The most informative
window is pre-open 09:15-09:29 ET; signals are suppressed while the market
is open (session=regular).
输入参数daysmin_abs_bps
perp_funding
Perp Funding Rates
Hourly funding rates on tokenized-stock perps (Arcus + Lighter). Without
params: latest value per venue+ticker pair (funding_apr_pct = annualized
%). With ticker: history. Tokens trade 24/7 while the stock market does
not — weekend/overnight funding is the price of that mismatch.
输入参数limitvenueticker
perp_spot_basis
Perp vs Spot Basis
Perp mark price vs Hood on-chain spot (Chainlink per-share + pool),
deviation in bps per ticker. A large |perp_vs_chainlink_bps| means the
perp and spot price the same stock differently — a cross-venue opportunity
or a stale-oracle signal. Fields are null for markets without a Hood spot.
输入参数min_abs_bps
funding_carry_signals
Funding Carry Signals
Deterministic funding-carry candidates joining perp funding
(Arcus/Lighter) with perp-vs-spot basis. Per ticker: funding rate +
annualized funding_apr_pct, perp-vs-Chainlink gap (bps) and a label —
carry_long_spot_short_perp (hold Hood spot, short the perp, collect
positive funding), carry_short_spot_long_perp (inverse) or no_carry —
plus the standard risk flags. min_abs_bps filters on
|perp_vs_chainlink_bps|. Signals are NOT orders.
输入参数min_abs_bps
narrative_trade_signals
Narrative Trade Signals
Deterministic candidates for the narrative-trader strategy: per Hood
ticker the highest-alpha Reddit signal (alpha_score, evidence, themes), a
signal bias (long_candidate = rising attention | avoid_or_fade = crowded
trade | context = regime info), live Chainlink price, basis and risk
flags. The `reason` field is the Reddit summary — carry it into status
reports and the chart as the buy/sell rationale. Signals are NOT orders.
输入参数hoursmin_alpha
Minimal fast quote for one Hood ticker: Chainlink price (token +
per-share), NASDAQ references (ref_last, ref_prev_close), basis/overnight
bps, the most liquid pool's price/liquidity/deviation and
oracle_paused/stale flags. Use for sizing and fill pricing instead of
pulling the full 32-ticker snapshot.
输入参数ticker必填
hood_ticker_brief
Hood Ticker Brief
One-call brief for a single Hood ticker: live quote (price, basis,
pool, risk flags), research card (rating/score/thesis/catalysts), earnings
risk, sector rotation context, best Reddit attention signal, 24h
whale-flow summary and recent tagged news. Replaces 6-7 separate tool
calls when an agent researches one ticker. Missing upstream sources
fail-soft: the field is null.
输入参数ticker必填
agent_position_book
Agent Position Book
Server-side derived open position book for a trading agent:
every order_filled event without a later matching position_closed on the
same ticker counts as open, joined with the live Chainlink price for
unrealized P&L (bps and USD). Replaces rebuilding the book from raw
agent events. agent: gap-trader | narrative-trader.
mode: '' (all) | paper | live | onchain — filter positions by execution mode.
输入参数modeagent
agent_performance
Agent Performance
Realized trading performance for an agent, derived from
position_closed events: trade count, win rate, total/average P&L (bps),
total P&L (USD), average holding hours, per-ticker breakdown and the last
20 closed trades. agent: gap-trader | narrative-trader.
mode: '' (all) | paper | live | onchain — filter trades by execution mode.
输入参数daysmodeagent
report_agent_status
Report Agent Status
Status report from a trading agent — the live panel on
ottodata.app/agents renders this stream. kind: run_started | signals |
order_proposed | order_approved | order_filled | order_skipped |
position_closed | run_summary | error. agent: gap-trader |
narrative-trader. key: the operator's OTTO_AGENT_KEY value (wrong keys are
rejected). Call at every runbook step; keep message short and
human-readable (e.g. 'BUY 3 NVDA @ 184.20 limit — gap +82bps').
输入参数key必填kind必填agentrun_idtickermessage必填payload
execute_onchain_swap
Execute Onchain Swap
Execute a REAL on-chain swap on Robinhood Chain via the Rialto router,
signed by Otto's server-side trading wallet. side=buy spends `usd_amount`
USDG to buy the ticker's Hood token; side=sell sells `qty` tokens back to
USDG. The server enforces hard guardrails independently of the caller:
USDG<->allowlisted-token pairs only, per-trade and daily USD caps, and a
slippage cap. On success the matching order_filled/position_closed event
(payload mode=onchain, with tx_hash) is written automatically — the
position book, performance stats and trade chart update without a
separate report_agent_status call. key: the operator's OTTO_AGENT_KEY.
agent: gap-trader | narrative-trader. Returns tx_hash, fill qty/price/usd
and pnl_bps (sells with a known entry).
输入参数key必填qtyside必填agentreasonrun_idticker必填usd_amountslippage_bps
competition_paper_trade
Competition Paper Trade
Place a PAPER fill in Otto's trading competition on behalf of the
key's owner. No real funds move — the fill is priced server-side at the
latest Chainlink price (callers can never supply a price). api_key: the
personal otto_pk_ key issued when the wallet joined at
ottodata.app/competition. side: buy | sell. qty: token quantity (shares).
Include a short `reason` — it shows up in the owner's trade history.
Rules enforced server-side: $10,000 starting budget, long-only, max
$2,000 notional per trade, max 10 open positions, max 40 trades/day.
On a rule violation the response is {"error": "..."} — read it and
adjust instead of retrying blindly.
输入参数qty必填side必填reasonticker必填api_key必填
competition_my_portfolio
Competition My Portfolio
The competition paper portfolio behind an otto_pk_ key: cash, equity,
return %, realized/unrealized P&L, open positions with live prices,
recent trades (each tagged with its source: your MCP agent or Otto's
hosted gap/narrative engine) and the entry's strategy prefs. Check this
before sizing a new competition_paper_trade.
输入参数api_key必填
competition_leaderboard
Competition Leaderboard
Public leaderboard of Otto's paper trading competition: every
participant ranked by return % on the shared $10,000 starting budget,
with equity, P&L, open position count, trade count and last activity.
No key required. Fills are server-priced from Chainlink, so rankings
cannot be gamed with self-reported prices.
输入参数limit
partner_swap_quote
Partner Swap Quote
Get an UNSIGNED Rialto swap quote for an approved partner. YOU sign
and broadcast the returned transaction yourself, with your own wallet's
private key, on your own infrastructure — Otto never sees or holds your
key and never submits anything on your behalf. api_key: the otto_pn_
key Otto's admin issued you directly. sell_token/buy_token: Hood token
contract addresses (0x...). sell_amount: human units of sell_token (e.g.
"25" USDG, not wei). taker: the wallet address that will actually sign
and hold the position. Returns the raw Rialto quote including tx.to,
tx.data, tx.value and min_buy_amount — everything needed to build and
sign the transaction. After broadcasting, call partner_report_fill so
the trade shows up in Otto's records.
输入参数taker必填api_key必填buy_token必填sell_token必填sell_amount必填slippage_bps
partner_report_fill
Partner Report Fill
Report a fill you already signed and broadcast yourself (via
partner_swap_quote) so it appears in Otto's records. Otto does NOT
verify the transaction on-chain in this version — it trusts the
partner it already approved. side: buy | sell. tx_hash: the
transaction hash from your own broadcast.
输入参数qtyusdside必填pricereasonticker必填api_key必填tx_hash必填
partner_my_trades
Partner My Trades
Recent fills you've reported with partner_report_fill, most recent
first.
输入参数limitapi_key必填