# Security + DeFi Yields Service
# x402 micropayment-gated API — pay per request in USDC on Base mainnet
# Base URL: https://x402.askew.network
# Network: Base mainnet (eip155:8453)
# Payment address: 0xfe86200836683D291bD084C9008403763E15b185
# Facilitator: https://facilitator.xpay.sh

## Free Endpoints (no payment required)
GET /health           — Service status, wallet address, pricing info
GET /offers           — Curated offer catalog with sample calls and buyer intent
GET /yields/preview   — Top yield pool per chain (free preview)
GET /.well-known/x402.json — Machine-readable service catalog

## Paid Endpoints (x402 micropayments)

### GET /check/quick — $0.001 USDC
System health check for infrastructure monitoring.
Returns: CPU %, memory %, disk %, load average, agent process status, listening ports.
Status values: ok | warning | critical
Use when: verifying system health before operations, monitoring agent infrastructure.

### GET /check/full — $0.005 USDC
Comprehensive security audit.
Returns: everything in /check/quick plus failed login attempts, SSH config issues, open port scan.
Use when: performing security due diligence, auditing a system before deploying agents.

### GET /check/crypto — $0.01 USDC
Crypto-focused security check.
Returns: full audit plus keystore file integrity, private key monitoring, wallet anomaly detection.
Use when: auditing infrastructure running crypto wallets or DeFi automation.

### GET /yields — $0.002 USDC
Live DeFi yield comparison across 5 chains.
Returns: top 5 pools per chain (Solana, Cosmos, Ethereum, Base, Arbitrum) with APY, TVL, project name.
Data source: DefiLlama. Cache: 6 hours.
Use when: optimizing staking strategy, comparing yield opportunities across chains.

### GET /staking/router — $0.003 USDC
Staking yield router for SOL and ATOM.
Returns: current native staking APY, top liquid staking alternatives (mSOL, stATOM, etc.), and a routing recommendation per chain.
Recommendation logic: if liquid staking APY exceeds native by >0.5%, recommend switching; otherwise recommend native.
Data sources: DefiLlama (liquid staking pools) + live staking portfolio data. Cache: 6 hours.
Use when: deciding whether to stake natively or use a liquid staking protocol, optimizing yield on SOL/ATOM holdings.

### GET /research/query — $0.003 USDC
Semantic search over the Askew agent ecosystem knowledge base.
Params: q=<search query> (required), collection=research_findings|agent_insights|experiments (default: research_findings), limit=1-20 (default: 5)
Returns: ranked results with text, metadata (topic, source, timestamp), and relevance score.
Collections: research_findings (500+ external findings on agent monetization, DeFi, agent economy), agent_insights (operational learnings from running agents), experiments (tracked experiments and outcomes).
Data source: ChromaDB vector search, updated every 12 hours by Research agent.
Use when: researching agent monetization strategies, finding yield opportunities, understanding agent economy trends.

### GET /intel/threats — $0.002 USDC
Live threat intelligence from the Guardian security monitor.
Params: hours=<lookback window> (default: 24, optional)
Returns: deduplicated WARNING/ERROR/CRITICAL entries from Guardian log, categorized by type (AUTH, DISK, CPU, NETWORK, etc.).
Data source: Guardian agent log (updated every 5 minutes).
Use when: checking for active security incidents, threat feed for autonomous agent decision-making.

### GET /intel/feed — $0.005 USDC
Aggregated intelligence feed combining research, security, and staking data.
Returns: top research findings (agent economy, DeFi, monetization), active security threats, and live staking APY snapshot.
Data sources: ChromaDB research library + Guardian log + staking.db.
Use when: need a broad intelligence overview for strategic decisions — single call instead of three separate queries.

### GET /staking/advisory — $0.005 USDC
Comprehensive staking advisory for SOL and ATOM.
Returns: portfolio positions, validator quality scores (commission, APY, Jito MEV for SOL), last 10 AI rebalancing decisions with reasoning, and liquid staking alternatives comparison.
Data sources: staking.db + DefiLlama.
Use when: evaluating staking strategy, understanding current portfolio, reviewing AI decision history.

## How to Pay (x402 protocol)
1. Make a GET request to the endpoint.
2. Receive HTTP 402 with payment requirements in X-Payment header.
3. Sign and submit EIP-712 payment message.
4. Retry with X-Payment header containing signed payment.
5. Receive 200 response with data.

## Example (using x402 Python SDK)
    from x402.client import x402_client
    client = x402_client(private_key="0x...")
    response = client.get("https://x402.askew.network/check/quick")
    print(response.json())

## Offer Discovery
Start with GET https://x402.askew.network/offers to see the curated paid routes, sample request URLs, and the main buyer questions each route answers.