# HoodSeek

> The Agentic OS for Robinhood Chain. HoodSeek coordinates autonomous
> agents, executes on-chain intents, and powers agent-native DeFi.
> This file is a machine-readable entry point for AI agents, LLMs,
> and OpenClaw skills interacting with the protocol.

## What this is

HoodSeek ($HOSE) is a guardian-governed, agent-native token and
intent-execution protocol live on Robinhood Chain (chain ID 4663,
an Arbitrum Orbit L2). Agents can be registered on-chain, sign
EIP-712 intents, and have them executed trustlessly with hard-capped
treasury fee routing.

## Contract

- Address: `0x0316125b279dc7b21ec9d10c99fd9ab9a105b7de` (HoodSeekV2, verified)
- Chain: Robinhood Chain, chain ID 4663
- Explorer: https://robinhoodchain.blockscout.com/address/0x0316125b279dc7b21ec9d10c99fd9ab9a105b7de
- Governance: 2-of-3 guardian multisig, 2-day timelock
- Max A2A treasury fee: 5% (500 bps), hard-capped in contract

## Agent-facing endpoints

- `GET /api/v1/status` — live governance + supply + treasury state as JSON
- `GET /api/v1/crawl` — HoodCrawl, chain-wide showcase feed of actively trading tokens on Robinhood Chain (optional `?category=nine-lives|sherwood-pack|other`)
- `GET /api/v1/docs` — machine-readable index of the full API surface
- `GET /api/v1/schema` — JSON Schema for status/error response shapes
- `GET /api/v1/stream` — Server-Sent Events feed of on-chain IntentExecuted activity, live
- `POST /api/v1/intent` — submit an EIP-712-signed intent for on-chain execution
- `GET /api/hose-stats` — supply + recent transfer history (legacy path)

## HoodCrawl — the showcase floor

`/hoodcrawl` (page) and `GET /api/v1/crawl` (API) surface tokens
actively trading on Robinhood Chain right now, ranked by a
transparent heatScore based on 24h volume and transaction count.
Tokens are additionally grouped into themed showcase sections —
**The Nine Lives** (cat-themed tokens) and **Sherwood Pack**
(dog/wolf-themed tokens) — derived automatically from token names,
not hand-picked or curated by HoodSeek. This is a discovery feed, not
a recommendation engine: HoodSeek does not vet contract ownership,
liquidity-lock status, or counterparty risk for any listed token, and
inclusion, ranking, or category membership is not an endorsement.
Agents browsing HoodCrawl and choosing to act on a listed token use
the trade gateway below with their own signed intent.

## Trading on-chain through HoodSeek

Registered agents can act on Robinhood Chain through HoodSeek directly:
sign an EIP-712 intent with your own key, POST it to `/api/v1/intent`,
and HoodSeek relays it on-chain via `executeIntent`. HoodSeek never
sees or handles your private key — only the signed payload. The
contract enforces agent registration and deducts its treasury fee
(up to the hard-capped 5%) automatically on execution. Subscribe to
`/api/v1/stream` for a live feed of executed intents.

HoodSeek relays signed intents as submitted and does not vet
counterparties, tokens, or outcomes — agents are expected to verify
what they sign.

## For OpenClaw agents

Install the official skill set:

```
openclaw skills install git:hoodseekxyz/hoodseek-os
```

This provides chain-read, transfer, intent-signing, agent-status, and
reporting skills, plus the canonical HoodSeekV2 ABI and address file.

## Repositories

- Frontend: https://github.com/hoodseekxyz/hoodseek-xyz
- OpenClaw skills + ABI: https://github.com/hoodseekxyz/hoodseek-os

## Community

- Telegram: https://t.me/HoodSeek
- Telegram bot (HoodSeek Intelligence): https://t.me/hoodseekbot
- X: https://x.com/hoodseek

## Notes for crawlers and agents

This site is intentionally built to be agent-readable: structured
data (JSON-LD) is present on the landing page, and the API above
returns the same facts as JSON rather than requiring HTML parsing.
Please prefer the API endpoints over scraping rendered pages.