Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyreagent.fun/llms.txt

Use this file to discover all available pages before exploring further.

​
API Overview

​
Base URL

https://mpp.hyreagent.fun
All endpoints are available on three chains via URL prefixes:
ChainPrefixExample
Solana/ (root)/defi/tvl
Base/base//base/defi/tvl
SKALE/skale//skale/defi/tvl

​
Authentication

HYRE uses x402 payment instead of API keys. Every paid request must include an X-PAYMENT header with a signed payment payload.
  1. Call the endpoint without payment to receive a 402 challenge.
  2. Sign the payment with your wallet.
  3. Retry with the X-PAYMENT header attached.
See x402 Protocol for details.

​
Standard Response Format

Every paid endpoint returns the HyreResponse envelope: 
{
  "data": {
    // Structured data from upstream sources
    // Shape varies per endpoint
  },
  "insight": "AI-generated actionable summary (1-2 sentences)",
  "signal": "actionable_signal",
  "confidence": 0.87,
  "sources": ["defillama", "jupiter"],
  "model_used": "deepseek-v3.2",
  "latency_ms": 342,
  "timestamp": "2026-04-17T10:30:00.000Z"
}
​
data
object
required
Structured data from upstream sources. Shape varies per endpoint.
​
insight
string
AI-generated actionable insight in 1-2 sentences. null if all LLM models failed (HTTP 206).
​
signal
string
required
Decision signal for the caller. Vocabulary depends on the endpoint segment.
​
confidence
number
required
LLM confidence in the signal, from 0.0 to 1.0.
​
sources
string[]
required
List of upstream data sources used (e.g., ["defillama"], ["solana-rpc", "jupiter"]).
​
model_used
string
Name of the LLM model that produced the insight. null on HTTP 206.
​
latency_ms
integer
required
Total response time in milliseconds (data fetch + LLM + response assembly).
​
timestamp
string
required
ISO 8601 timestamp of the response.

​
Signal Vocabulary

Each endpoint segment uses a specific set of signals:
SegmentSignalsMeaning
Trenchessnipe, watch, avoidToken action recommendation
Trenches (graduation)graduate_soon, watchBonding curve urgency
Tradersfollow, ignoreWallet copy-trade worthiness
Traders (holdings)accumulate, distribute, ignorePosition momentum
LPsadd_liquidity, rebalance, hold, removeLP position action
DeFihigh_yield, medium_yield, low_yield, riskyYield risk assessment
deBridge (quote)execute, wait, avoidBridge execution timing
deBridge (yield)migrate, stay, waitCross-chain move decision
Nansenfollow, ignore, accumulate, distributeSmart money action

​
HTTP Status Codes

CodeMeaning
200Success — full AI-enriched response
206Partial — raw data returned, LLM enrichment failed
402Payment Required — attach x402 payment header
400Bad Request — invalid parameters
404Not Found — endpoint does not exist
500Server Error — unexpected failure

​
Request Methods

All endpoints support both GET and POST:
Parameters in the JSON body. Preferred for x402 compatibility.
curl -X POST https://mpp.hyreagent.fun/trenches/token-verdict \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <payment>" \
  -d '{"mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"}'

​
OpenAPI Specification

The full OpenAPI 3.1 spec is available at: 
https://mpp.hyreagent.fun/openapi.json
It includes x-payment-info extensions for every endpoint with pricing, network details, and facilitator URLs.