{"openapi":"3.1.0","info":{"title":"hoodr trading API","version":"0.1.0","description":"Trade tokenized stocks (spot + perps) on Robinhood Chain. Amounts for buy/swap accept ETH (\"0.05\") or USD (\"$50\"). All trades are capped server-side."},"servers":[{"url":"https://mcp.hoodr.trade"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/api/balance":{"get":{"operationId":"getBalance","summary":"ETH + stock balances","parameters":[{"name":"address","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/api/quote":{"post":{"operationId":"quote","summary":"Preview a spot trade","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["side","ticker","amount"],"properties":{"side":{"type":"string","enum":["buy","sell"]},"ticker":{"type":"string"},"amount":{"type":"string"},"slippageBps":{"type":"number"}}}}}},"responses":{"200":{"description":"ok"}}}},"/api/buy":{"post":{"operationId":"buyStock","summary":"Buy a stock with ETH/USD","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ticker","ethAmount"],"properties":{"ticker":{"type":"string"},"ethAmount":{"type":"string"},"slippageBps":{"type":"number"}}}}}},"responses":{"200":{"description":"ok"}}}},"/api/sell":{"post":{"operationId":"sellStock","summary":"Sell a stock for ETH","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ticker","amount"],"properties":{"ticker":{"type":"string"},"amount":{"type":"string"},"slippageBps":{"type":"number"}}}}}},"responses":{"200":{"description":"ok"}}}},"/api/swap-usdg":{"post":{"operationId":"swapUsdg","summary":"Swap ETH into USDG (perp collateral)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ethAmount"],"properties":{"ethAmount":{"type":"string"},"slippageBps":{"type":"number"}}}}}},"responses":{"200":{"description":"ok"}}}},"/api/positions":{"get":{"operationId":"getPositions","summary":"Open perp positions","parameters":[{"name":"address","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/api/open":{"post":{"operationId":"openPerp","summary":"Open a leveraged perp","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ticker","side","leverage","marginUsd"],"properties":{"ticker":{"type":"string"},"side":{"type":"string","enum":["long","short"]},"leverage":{"type":"number"},"marginUsd":{"type":"number"}}}}}},"responses":{"200":{"description":"ok"}}}},"/api/close":{"post":{"operationId":"closePerp","summary":"Close a perp position","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}}}}}},"responses":{"200":{"description":"ok"}}}}}}