{"id":"io.github.0xHedgeHood/hedgehood-options","slug":"io-github-0xhedgehood-hedgehood-options","title":"Hedgehood Options","description":"Stock options market for AI agents on Robinhood Chain: RFQ quotes, buy/close, P&L, x402 deposits.","version":"0.5.1","publisher":{"kind":"github","id":"0xHedgeHood","label":"@0xHedgeHood on GitHub","url":"https://github.com/0xHedgeHood"},"website":"https://hedgehood.app","repository":"https://github.com/0xHedgeHood/hedgehood-agent-kit","remotes":[{"type":"streamable-http","url":"https://mcp.hedgehood.io/mcp"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@hedgehood-io/mcp","version":"0.5.1","runtimeHint":"npx","transport":{"type":"stdio"},"environmentVariables":[{"description":"46630 (Robinhood testnet, default) or 4663 (mainnet)","format":"number","default":"46630","name":"HEDGEHOOD_CHAIN_ID"},{"description":"Path to a file holding the agent's session private key (0x + 64 hex, chmod 600). The key can trade and cancel for the account but never withdraw.","isRequired":true,"format":"filepath","isSecret":true,"name":"HEDGEHOOD_SESSION_KEY_FILE"},{"description":"The owner (trading) account the session key acts for. Defaults to the session key's own address.","format":"string","name":"HEDGEHOOD_ACCOUNT"},{"description":"Optional owner key file; unlocks withdraw, deposit from the owner wallet, authorize_session and register_agent. Keep it off shared machines.","format":"filepath","isSecret":true,"name":"HEDGEHOOD_OWNER_KEY_FILE"},{"description":"RPC override for the chain","format":"string","name":"HEDGEHOOD_RPC_URL"},{"description":"Quote service override (default per chain: https://agent-api.hedgehood.io on mainnet, https://testnet-agent-api.hedgehood.io on the testnet)","format":"string","name":"HEDGEHOOD_RFQ_URL"},{"description":"Indexer override (default per chain: https://agent-index.hedgehood.io on mainnet, https://testnet-agent-index.hedgehood.io on the testnet)","format":"string","name":"HEDGEHOOD_INDEXER_URL"},{"description":"x402 deposit gateway override (default per chain: https://agent-pay.hedgehood.io on mainnet, https://testnet-agent-pay.hedgehood.io on the testnet)","format":"string","name":"HEDGEHOOD_GATEWAY_URL"},{"description":"\"false\" makes write tools broadcast by default (they still need confirm: true). Default true: simulate only.","format":"boolean","default":"true","name":"HEDGEHOOD_DRY_RUN"},{"description":"Cap per x402 deposit, USDG","format":"number","default":"1000","name":"HEDGEHOOD_MAX_DEPOSIT"}]}],"published":"2026-11-03","updated":"2026-11-03","status":"online","auth":"","latency_ms":1555,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_markets","title":"","description":"The option markets: underlying, addresses, version, open expiries.","read_only":false},{"name":"list_instruments","title":"","description":"Instruments (expiry x strike x call/put) with their on-chain ids. expiry as YYYYMMDD or unix seconds.","read_only":false},{"name":"get_mark","title":"","description":"Model bid / ask / mid (USDG per share), delta and whether a quote would be given. instrument like NVDA-20261016-200-C.","read_only":false},{"name":"get_quote","title":"","description":"A signed quote addressed to `account` for `quantity` shares (buy or sell), valid for seconds, with the exact calldata\n        to send to fillOrderAs from the owner key or the given session key, the fee, the decay and a canFill preview (with a\n        session_key it also checks the key's live TRADE session, its spend budget spendLeft and its short-risk budget riskLeft). Sells are close-only: side=s","read_only":false},{"name":"close_quote","title":"","description":"The quote that exits `account`'s open position in `instrument` before expiry: reads the position, takes the opposite\n        side (long -> sell, short -> buy), size = min(|position|, quantity or the whole position), and returns the desk's signed\n        quote with the fillOrderAs calldata in fill.send. You must send it with your own key before validUntil\n        (`hedgehood close <instrument> --se","read_only":false},{"name":"get_positions","title":"","description":"ACTIVE positions: open positions, cost basis and leaderboard row of an account (and its ERC-8004 agent id when it has\n        one). Past activity is get_history; marks / PnL are get_pnl; exit before expiry with close_quote.","read_only":false},{"name":"get_pnl","title":"","description":"PnL of an account: every position (open / closed / settled) with the desk's mark, unrealized and realized PnL, fees paid\n        and the total, all USDG raw (1e6) signed from the account's side, plus a one-line `summary` in USDG.","read_only":false},{"name":"get_history","title":"","description":"PAST activity of an account, newest first: fills (your side buy / sell, price, premium, fee), settlements (payout, PnL)\n        and redeems, at most `limit` (<= 500) and after `since` (unix seconds), plus a one-line `summary`. Open positions are\n        get_positions.","read_only":false},{"name":"get_refusals","title":"","description":"Why the desk refused quotes to `taker` (your account) in the last 48 h, newest first: code, reason, instrument, side and\n        quantity as asked, plus counts by code and what to do about each code. At most `limit` (<= 500) rows; read-only.","read_only":false},{"name":"get_leaderboard","title":"","description":"Leaderboard per account or per ERC-8004 agent id (by='agent'): fills, premium paid / received, settled PnL.","read_only":false},{"name":"get_agent_record","title":"","description":"The ERC-8004 Identity Registry record of an agent id and the accounts seen trading under it.","read_only":false},{"name":"how_to_deposit","title":"","description":"How to fund a market balance with USDG over x402 (and the direct deposit path). amount in USDG. On mainnet the answer\n        carries `onramp`: a MoonPay buy link for USDG delivered on Robinhood Chain to `account`, for an agent that holds no USDG\n        yet (a human completes KYC and payment; not in New York or Canada); on the testnet it names the faucet / wallet path. Also: how the owner authori","read_only":false},{"name":"how_to_get_test_funds","title":"","description":"TESTNET only: how to get the test settlement token (TestUSD, hUSD-test, no value). Returns the faucet call (to, data =\n        faucet(): a fixed amount to the caller once per cooldown), the account's balance and next draw time when readable, and the\n        onboarding steps: connect -> faucet -> deposit -> session key -> quote -> fill. Read-only: your own wallet sends the call.\n        Mainnet ans","read_only":false},{"name":"list_vaults","title":"","description":"The Hedgehood OptionVault v2 funds (hhNVDA-CC, hhNVDA-WHEEL, hhGOOGL-CC, ...): stock token, deposit cap and room, total\n        shares, NAV per share (USDG, from the chain), the current epoch (index, phase, cutoff / trade window / expiry, next freeze)\n        and the deposit gate. Vaults are passive weekly premium income held for weeks, not a trade: a deposit queues, becomes shares\n        at the ","read_only":false},{"name":"vault_status","title":"","description":"An account's standing in every fund: shares (credited and owed by a frozen deposit), value at NAV, the pending deposit or\n        redemption with its cohort epoch and cutoff, what is claimable, the fund's epoch state and the next step (wait / claim /\n        redeem). The cycle is request -> freeze / settlement -> claim: a request is never instant.","read_only":false},{"name":"vault_deposit_quote","title":"","description":"The unsigned calldata to deposit `usdg` USDG into `vault` (address or symbol like hhNVDA-CC) for `account`: `txs` = USDG\n        approve (when the allowance is short) then requestDeposit(0, usdg, account), with the cohort epoch and its cutoff, a share\n        estimate at today's NAV, the balance / cap / eligibility checks and the cancelDeposit calldata. The deposit is NOT instant: it\n        is pr","read_only":false},{"name":"vault_redeem_quote","title":"","description":"The unsigned calldata to redeem `shares` (a decimal or 'all') of `vault` for `account`: requestRedeem(shares, account),\n        the cohort it joins and when it pays, the cancelRedeem calldata. The shares go into escrow now and are paid IN KIND (stock\n        and/or USDG at that freeze's NAV) when the cohort freezes: in a locked epoch that is after the current option expires, up to\n        a week; ","read_only":false},{"name":"vault_claim_quote","title":"","description":"The unsigned calldata to collect what `account`'s redemption (or refunded deposit) in `vault` paid: claim(account, account)\n        with the claimable stock and USDG amounts; nothing_to_claim with the pending redemption's cutoff when it has not frozen yet.\n        You send it with the account's own owner key; this server never sends.","read_only":false},{"name":"lend_status","title":"","description":"Share Lending, LEND side: the Morpho Vault V2 that lends USDG against Hedgehood fund shares (hhNVDA-CC) on Morpho Blue — vault,\n        total assets, cap and room, the live market's utilization and borrow rate, an approximate supply APY (net of the vault's 10%\n        performance fee), and `my`: the account's vault shares, their USDG value and its wallet USDG. Deposits mint shares at once and\n    ","read_only":false},{"name":"lend_deposit_quote","title":"","description":"The unsigned calldata to lend `usdg` USDG: `txs` = USDG approve (when the allowance is short) then the vault's ERC-4626\n        deposit(usdg, account), with the share preview, the APY estimate and the cap / gate / balance checks as {error, reason}\n        (cap_exceeded, insufficient_balance, paused, not_eligible). You send every tx with the account's own owner key (needs ETH for\n        gas); this","read_only":false},{"name":"lend_withdraw_quote","title":"","description":"The unsigned calldata to take lent USDG back: withdraw(usdg, account, account), or redeem(all shares, account, account) for\n        'all' (exact, no dust). insufficient_balance when the account holds less, insufficient_liquidity when the vault's idle USDG plus\n        the market's unborrowed supply cannot pay it now. You send it with the account's own owner key; this server never sends.","read_only":false},{"name":"borrow_status","title":"","description":"Share Lending, BORROW side: the Morpho Blue market that takes hhNVDA-CC fund shares as collateral for USDG — id (discovered from\n        the lending vault at each call; the mainnet market is being migrated to a new oracle), LLTV, the ShareRiskOracle price and status\n        (live / held / unavailable), borrow rate, utilization, supply, borrowed, available — and `my`: collateral, debt (interest to ","read_only":false},{"name":"borrow_supply_collateral_quote","title":"","description":"The unsigned calldata to post `shares` fund shares (a decimal or 'all' of the wallet) as collateral: approve to Blue (when the\n        allowance is short) + supplyCollateral(marketParams, shares, account, 0x), with the position before and after (HF, LTV). No\n        oracle read. insufficient_balance when the wallet holds fewer shares (shares still in the fund's redemption queue do not count).\n    ","read_only":false},{"name":"borrow_take_quote","title":"","description":"The unsigned calldata to borrow `usdg` USDG against posted collateral: borrow(marketParams, usdg, 0, account, account), with the\n        post-action HF / LTV and a `warning` when the resulting LTV is above 70% of LLTV. Refused with oracle_stale when the ShareRiskOracle\n        is fail-closed (Blue cannot price the collateral), unhealthy when HF would drop below 1 (with the most you could add),\n   ","read_only":false},{"name":"borrow_repay_quote","title":"","description":"The unsigned calldata to repay USDG debt: approve to Blue (when short) + repay(marketParams, usdg, 0, account, 0x), or for 'all'\n        repay by the exact share debt (no dust; the approval carries 0.1% headroom for interest until the tx lands), with the post-action\n        HF / LTV. nothing_to_repay, exceeds_debt, insufficient_balance are answers. Repay reads no oracle: it works while the oracle ","read_only":false},{"name":"borrow_withdraw_collateral_quote","title":"","description":"The unsigned calldata to take fund shares back from Blue: withdrawCollateral(marketParams, shares, account, account), with the\n        post-action HF / LTV and the 70%-of-LLTV warning. Refused with unhealthy when the remaining collateral would not cover the debt,\n        oracle_stale when there is debt and the oracle is fail-closed (no debt: no oracle read, always allowed), insufficient_collateral","read_only":false}],"server_info":{"name":"hedgehood-options","version":"1.30.0"},"category":"crypto","tags":["finance","sales","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-28","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-0xhedgehood-hedgehood-options/"}