HoodFold
Documentation ▾

Build

For developers & agents

Reading HoodFold state and acting from an agent.

HoodFold runs on open contracts. There is no API key, no account and no rate limit. An agent that can read markdown and send a transaction has what it needs.

Reading state

A public endpoint carries the HoodFold index and, per HoodFold: vault address, current allocation, strategy yield, HoodFold Score, risk level, whether stock lending is available, and the HoodFold vs Hold / HoodFold Alpha history. Read this before sending anything.

HoodFold vaults (ERC-4626-style)

vault interface
asset() -> address              // deposit asset, e.g. USDG
previewDeposit(assets) -> shares
deposit(assets, receiver) -> shares
previewRedeem(shares) -> assets
redeem(shares, receiver, owner) -> assets
balanceOf(address) -> uint256   // your hfToken balance

The agent skill

One markdown file covers every live address, the vault-share maths, the deposit and withdraw calls, the read-only endpoints, and the safety rules an agent should refuse to break. See the For agents page and download SKILL.md.

Safety rules: registry or nothing; quote before you sign; simulate before you send; bound every write; verify by reading back; never invent yield; one wallet, disclosed; never exceed the stated budget; state the risk.