// Story & Philosophy · Robinhood Chain 4663
Verification first,
execution second.
A trading agent is only as safe as the verification pipeline behind it. Frogent is built so the model may analyze and propose routes, but executes strictly under your deterministic rules.
01 / The Guarded Path
Read → Prepare → Execute
// Step 01
Read Only
Tier 1 tools inspect Robinhood Chain pools, Hyperliquid order books, your positions, and token bytecode. Nothing at this stage can spend, sign, or broadcast a transaction.
// Step 02
Prepare & Frogent Gate
The assistant drafts a proposal ticket or returns a one-time confirmationId. Frogent Gate runs 7 live checks against the chain and your policy limits before you ever see it.
// Step 03
Sign & Audit
You sign in your own wallet — or the optional Agent Wallet signs inside your daily caps. The exact rationale and policy rule are written permanently into your audit journal.
02 / Wide Eyes, Narrow Hands
Architecture Principles
A · Policy Outside Model
Hard Server Caps
Limits live in policy.json on the server, never inside a system prompt. No prompt injection can alter your daily ceiling.
B · Ephemeral Tickets
120s Confirmations
Every prepared order is bound to a cryptographic hash of its parameters and expires in 120 seconds over API/MCP (10m in chat).
C · Mainnet Brakes
Instant Pause
One switch freezes your Agent Wallet and playbooks immediately, backed by an operator-wide emergency kill switch.
D · Fenced Untrusted Text
Prompt Immunity
Token names, descriptions, and social posts are fenced as untrusted data so malicious instructions inside a token ticker are never obeyed.
// Capabilities · Full-Stack Desk
Everything it reads.
Every way it acts.
Frogent splits its work in two: read-only market intelligence across Robinhood Chain and Hyperliquid, and a guarded three-step execution engine available in the Web App, over MCP, and via REST.
01 / Market Reading Tools
Tier 1 · Zero Key Access
| Tool Name | What It Reads on Live Mainnet | Tier |
|---|
analyze_ticker | Snapshot of any Hyperliquid perp: mark & oracle price, 24h volume, OI, hourly funding, and L2 book depth. | READ |
get_movers | Top risers and fallers across Hyperliquid perps and Robinhood Chain tokens with volume/OI ratios. | READ |
get_robinhood_tokens | Live Robinhood Chain (4663) token board from on-chain reads, Pons curves, and GeckoTerminal pools. | READ |
analyze_token_health | Inspects contract bytecode on chain 4663 and flags mint, pause, blacklist, fee-switch, and owner powers. | READ |
quote_swap | Quotes swaps across Pons bonding curves and Uniswap v3/v4 pools with price impact and minimum-out. | READ |
02 / Trading Venues
Chain 4663 + Hyperliquid L1
// Venue 01 · Robinhood Chain (4663)
Pons Curves & Uniswap v3 / v4 Swaps
Trade native coins and tokenized equities (NVDA, TSLA, SPY) routed automatically through Pons bonding curves before graduation and Uniswap v3/v4 pools afterward.
// Venue 02 · Hyperliquid Perps
Simulated Order Book Execution
Every listed perpetual market — long or short, market or limit, with leverage, TP, and SL in one ticket. Fills are simulated level-by-level against the live book.
// Risk Controls & Frogent Gate
The walls,
in full detail.
Every limit lives in server policy outside the LLM. Every swap passes 7 live on-chain checks through Frogent Gate before a transaction is built, and re-runs right before your wallet signs.
01 / Frogent Gate Pre-Trade Matrix
Live Chain 4663 Verification
| Gate Check | Pass Threshold | Warn Threshold | Hard Block (Fail) |
|---|
| 01 · Route Existence | Valid Pons or Uniswap v3/v4 route | — | No route found |
| 02 · Price Impact | ≤ 5.0% | > 5.0% | > 15.0% |
| 03 · Pool Depth (ETH side) | ≥ 0.50 ETH | < 0.50 ETH | < 0.05 ETH |
| 04 · Pool & Curve Fees | ≤ 5.0% | > 5.0% | > 10.0% |
| 05 · Exact Swap Simulation | Calldata succeeds on live pool | — | Transaction reverts |
| 06 · Test Sell Simulation | Selling output token succeeds | — | Honeypot / sell reverts |
| 07 · Transfer / Creator Tax | ≤ 0.5% | > 0.5% | > 10.0% |
02 / Key Custody & Brakes
Non-Custodial Default
// Key 01 · Held By You
Your Browser Wallet
Frogent never sees or stores your private key. The server builds unsigned calldata from scratch; you review and sign every transaction in your own wallet.
// Key 02 · Optional Hot Wallet
Capped Agent Wallet
Encrypted at rest (AES-256-GCM). Bound by your per-trade USD cap, rolling 24h USD ceiling, leverage cap, and token allowlist. Can only withdraw back to your connected owner wallet.
// Key 03 · Venue Scoped
Hyperliquid Agent Key
Approved for placing and cancelling perp orders only. Hyperliquid L1 enforces that an agent key can never withdraw or transfer funds.
// API & Model Context Protocol
Give your agent
an intelligent desk.
Connect Claude Desktop, Cursor, or Claude Code with a single MCP command, or call the REST API directly. Execution ships in dry-run by default so a fresh install can never place a live order by accident.
// Quick Install · Claude Desktop & Cursor
MCP Configuration (@frogent/mcp)
Runs locally over stdio, holds zero keys, and forwards calls through your Frogent Gate safety rules:
{
"mcpServers": {
"frogent": {
"command": "npx",
"args": ["-y", "@frogent/mcp"],
"env": {
"FROGENT_BASE_URL": "https://frogent.codes/agent/api",
"FROGENT_API_KEY": ""
}
}
}
}
// Claude Code CLI & REST
One-Line Terminal Setup
Add read-only market intelligence or attach an Agent Wallet API token:
# Read tools only (no token required)
claude mcp add frogent -- npx -y @frogent/mcp
# Guarded 2-step REST execution
curl -X POST "https://frogent.codes/agent/api/tools/prepare_order" \
-H "x-api-key: $FROGENT_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"venue":"hyperliquid","coin":"ETH","side":"long","sizeUsd":100,"leverage":3}'
Public & Guarded REST Endpoints
Base: /agent/api
| Method | Endpoint | Description | Authentication |
|---|
| GET | /market/robinhood | Robinhood Chain (4663) token board, prices, volume, and launchpads. | Public |
| GET | /market/hl | Hyperliquid perp markets: mark, 24h change, funding APR, OI, volume. | Public |
| GET | /tools | Full tool registry with Tier 1 / Tier 2 / Tier 3 schemas. | Public |
| POST | /tools/:name | Run read, prepare, or execute tools against your policy and journal. | x-api-key + Idempotency-Key |
