{
  "markdown": "# Kristo Intelligence — x402 Pay-Per-Call API\n\n> Pay-per-call DeFi intelligence API for AI agents on Base blockchain (Chain ID 8453). Powered by the x402 protocol.\n\n## 🚀 Quick Start\n\n```bash\n# 1. Call any paid endpoint (get 402 + payment instructions)\ncurl https://kristo-intelligence-api.onrender.com/defi/yields\n\n# 2. Server responds with 402 + payment details:\n# {\n#   \"x402_version\": 1,\n#   \"accepts\": {\n#     \"scheme\": \"exact\",\n#     \"network\": \"base\",\n#     \"chain_id\": 8453,\n#     \"asset\": \"USDC\",\n#     \"amount\": \"0.01\",\n#     \"payTo\": \"0xd4cdA980839C8FED4374EE37EA8DBE8c4ECfd88f\"\n#   }\n# }\n\n# 3. Send 0.01 USDC on Base to payTo address, then retry with tx hash:\ncurl -H \"X-PAYMENT: 0xYOUR_TX_HASH\" https://kristo-intelligence-api.onrender.com/defi/yields\n```\n\n## 💰 Pricing\n\n| Type | Price | Endpoints |\n|------|-------|-----------|\n| **Paid** | 0.01 USDC/call | 10 endpoints |\n| **Freemium** | Free (rate-limited) | token-prices, gas-oracle |\n| **Free** | Free | metadata, health, pricing, stats |\n\n**Hooks:**\n- 🎁 First 3 calls FREE for new wallets\n- 📊 After 50 paid calls → 0.005 USDC/call (50% off)\n- 🔗 Referral program: earn 20% of referred agent's payments\n\n## 📡 Endpoints\n\n### Paid (0.01 USDC/call)\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /defi/yields` | Top 10 Base DeFi yield pools by TVL |\n| `GET /defi/tvl-movers` | Base protocols with biggest 1-day TVL changes |\n| `GET /defi/lending-rates` | Best lending/borrowing rates on Base |\n| `GET /defi/dex-pools` | Top DEX liquidity pools (Aerodrome, Uniswap) |\n| `GET /defi/protocol-safety` | Risk scores for Base DeFi protocols |\n| `GET /crypto/token-launches` | Recently launched tokens on Base |\n| `GET /crypto/token-security` | 🛡️ Rug-pull & honeypot detection scanner |\n| `GET /crypto/wallet-profile` | On-chain wallet analysis & classification |\n| `GET /crypto/whale-moves` | Large USDC transfers on Base |\n| `GET /crypto/bridge-volume` | Cross-chain bridge volume to/from Base |\n\n### Freemium (free with rate limiting)\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /crypto/token-prices` | Real-time token prices from CoinGecko |\n| `GET /crypto/gas-oracle` | Base gas price & cost estimates |\n\n### Free\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /` | Service metadata & endpoint roster |\n| `GET /health` | API health & Web3 connectivity |\n| `GET /pricing` | Transparent pricing & hooks info |\n| `GET /stats` | Public usage statistics |\n| `GET /sales/recent` | Recent sales log |\n| `GET /agent/intelligence` | Autonomous intelligence report |\n| `GET /agent/recommendations` | AI-generated recommendations |\n\n## 🛡️ Token Security Scanner\n\nThe `/crypto/token-security` endpoint provides comprehensive rug-pull detection:\n\n```bash\ncurl -H \"X-PAYMENT: 0xTX_HASH\" \\\n  \"https://kristo-intelligence-api.onrender.com/crypto/token-security?address=0xTOKEN_ADDRESS\"\n```\n\nReturns:\n- `is_safe` (bool) — safe to interact with\n- `is_honeypot_suspected` (bool) — potential honeypot\n- `risk_score` (0-100) — higher is safer\n- `risk_level` — \"Low Risk\" / \"Medium Risk\" / \"High Risk\" / \"Critical Risk\"\n- `risk_factors` — detailed list of findings\n- `recommendation_for_ai_agent` — buy/avoid decision with confidence\n\n## 🧠 Autonomous Intelligence Engine\n\nThe API includes a built-in intelligence engine that runs every hour:\n- Analyzes sales patterns and endpoint popularity\n- Checks CoinGecko for trending tokens\n- Generates dynamic pricing recommendations\n- Identifies underperforming endpoints\n- Stores all reports in SQLite\n\nAccess via `GET /agent/intelligence` or `GET /agent/recommendations`\n\n## 🔗 Links\n\n- **API**: https://kristo-intelligence-api.onrender.com\n- **Dashboard**: https://kristo-travel-dashboard.vercel.app\n- **GitHub**: https://github.com/hristovdimitri2-hub/kristo-travel-api\n- **Network**: Base Mainnet (Chain ID 8453)\n- **Payment**: USDC via x402 protocol\n- **Wallet**: `0xd4cdA980839C8FED4374EE37EA8DBE8c4ECfd88f`\n\n## 🏗️ Tech Stack\n\n- **Backend**: FastAPI + Python 3\n- **Hosting**: Render (API) + Vercel (Dashboard)\n- **Blockchain**: Base Mainnet (Chain ID 8453)\n- **Payments**: x402 protocol with USDC\n- **Data Sources**: DefiLlama, CoinGecko, direct RPC\n- **Database**: SQLite (replay protection + sales logs + intelligence reports)\n\n## 📄 License\n\nMIT\n",
  "bytes": 4297,
  "sha": "97c1a884ef7ed56e1e9b0aa27de4d07efd73c805b35925bcd419ef48cd2cba57",
  "repo_slug": "hristovdimitri2-hub/kristo-travel-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hristovdimitri2_hub_kristo_int_f902b5a8/readme"
}