# HYRE Agent — AI-Enhanced DeFi Intelligence API

HYRE provides AI-interpreted DeFi data across 24 endpoints on Solana. Every response includes LLM insights with confidence-scored signals. No API keys — pay per request via x402 (USDC).

## Payment

- **Protocol**: x402 (HTTP 402 Payment Required)
- **Currency**: USDC
- **Networks**: Solana mainnet, Base (EVM), SKALE (EVM, zero gas)
- **Facilitators**: Solana via Dexter (gas sponsored), Base/SKALE via PayAI

## Endpoints & Pricing

### Trenches (Token Launches & Meme Coins)

| Endpoint | Method | Price | Description | Parameters |
|----------|--------|-------|-------------|------------|
| `/trenches/new-tokens` | POST | $0.008 | Latest token launches from PumpPortal | `limit` (int, default 10) |
| `/trenches/curve` | POST | $0.001 | Bonding curve progress for a PumpFun token | `mint` (string, required) |
| `/trenches/token` | POST | $0.002 | Token metadata + top holders | `mint` (string, required) |
| `/trenches/token-snipers` | POST | $0.004 | Detect wallets that bought in first few blocks | `mint` (string, required) |
| `/trenches/token-verdict` | POST | $0.015 | Full AI verdict — holders, snipers, bonding curve, risk | `mint` (string, required) |
| `/trenches/graduating` | POST | $0.003 | Tokens near bonding curve graduation (>70% progress) | `limit` (int, default 10) |
| `/trenches/bags/new-tokens` | POST | $0.008 | New tokens from Bags.fm | `limit` (int, default 10) |

### Traders (Wallet Analytics)

| Endpoint | Method | Price | Description | Parameters |
|----------|--------|-------|-------------|------------|
| `/traders/wallet-pnl` | POST | $0.005 | Wallet PnL — realized + unrealized, portfolio value | `address` (string, required) |
| `/traders/wallet-positions` | POST | $0.003 | Wallet token positions and holdings | `address` (string, required) |
| `/traders/wallet-intel` | POST | $0.012 | Full 30-day wallet intelligence — patterns, success rate | `address` (string, required) |
| `/traders/top-wallets` | POST | $0.008 | Top performing wallets on Solana | `limit` (int, default 10) |
| `/traders/token-whales` | POST | $0.003 | Whale holders for a token with % of supply | `mint` (string, required) |
| `/traders/token-ohlcv` | POST | $0.002 | Token price + activity data | `mint` (string, required) |

### LPs (Liquidity Provision)

| Endpoint | Method | Price | Description | Parameters |
|----------|--------|-------|-------------|------------|
| `/lp/pools` | POST | $0.001 | Meteora DLMM pool list with APR, TVL, volume | `limit` (int, default 10), `token` (string, optional) |
| `/lp/pools-recommend` | POST | $0.008 | AI pool recommendation for a token pair | `base` (string, e.g. "SOL"), `quote` (string, e.g. "USDC") |
| `/lp/pool-detail` | POST | $0.003 | Detailed pool info | `address` (string, required) |
| `/lp/wallet-positions` | POST | $0.004 | LP positions for a wallet | `address` (string, required) |
| `/lp/position-rebalance` | POST | $0.010 | Rebalance analysis for an LP position | `id` (string, required) |
| `/lp/pools-strategy` | POST | $0.020 | Full LP strategy advisor | `token_pair` (string, e.g. "SOL-USDC"), `capital_usdc` (string) |

### DeFi (Cross-Chain Data)

| Endpoint | Method | Price | Description | Parameters |
|----------|--------|-------|-------------|------------|
| `/defi/tvl` | POST | $0.001 | Total Value Locked across chains | `chain` (string: solana\|ethereum\|all), `limit` (int) |
| `/defi/yields` | POST | $0.002 | Top yield pools multi-chain sorted by APY | `chain`, `stablecoin` (bool), `min_apy` (number), `limit` |

### Cross-Chain (deBridge)

| Endpoint | Method | Price | Description | Parameters |
|----------|--------|-------|-------------|------------|
| `/debridge/quote` | POST | $0.002 | Cross-chain USDC quote via deBridge DLN | `src`, `dst` (chain names), `token`, `amount` |
| `/debridge/yield-migrate` | POST | $0.005 | Cross-chain yield migration advisor | `src`, `token`, `amount`, `min_tvl_usd`, `whitelist` |

### Ask (Natural Language)

| Endpoint | Method | Price | Description | Parameters |
|----------|--------|-------|-------------|------------|
| `/ask` | POST | $0.025 | Natural language DeFi query — AI orchestrates data sources | `query` (string, required) |

## Response Format

Every endpoint returns:
```json
{
  "data": {},
  "insight": "AI-generated analysis (1-2 sentences)",
  "signal": "actionable signal (e.g. snipe, follow, add_liquidity, high_yield)",
  "confidence": 0.85,
  "sources": ["jupiter", "defillama"],
  "model_used": "claude-3.5-haiku",
  "latency_ms": 1234,
  "timestamp": "2026-04-13T00:00:00.000Z"
}
```

## Signal Vocabulary

- **Trenches**: snipe / watch / avoid
- **Traders**: follow / ignore
- **LPs**: add_liquidity / rebalance / hold
- **DeFi**: high_yield / low_yield
- **deBridge**: execute / wait / avoid
- **Yield Migrate**: migrate / stay / wait

## Links

- API: https://mpp.hyreagent.fun
- OpenAPI: https://mpp.hyreagent.fun/openapi.json
- Website: https://hyreagent.fun
- MCP: https://www.npmjs.com/package/hyre-mcp
- X: https://x.com/hyre_agent