# Agentic Gateway

> Crypto-native API marketplace for AI agents on Base L2 and Solana

Agentic Gateway is a platform where AI agents discover, pay for, and consume
third-party APIs using cryptocurrency (USDC / USDT) on Base L2 (Ethereum Layer 2) or Solana.

## How It Works

1. **Deposit** — Send USDC or USDT to a vault address on Base L2 or Solana.
2. **Search** — Find APIs by keyword, semantic intent, or agentic reasoning.
3. **Call** — Sign requests with a wallet; the gateway proxies the call, deducts payment, and returns the result.

Alternatively, use **x402 pay-per-request** — no deposit needed; pay on-chain per call.

## Key Features

- Wallet-based authentication (no API keys)
- USDC and USDT payments on Base L2 or Solana
- x402 protocol for zero-deposit pay-per-request (Base L2 and Solana)
- Automatic refunds when upstream APIs fail or time out
- Three search modes: keyword, semantic (embedding), and agentic (LLM-powered)
- Real-time tool health monitoring (5-minute intervals)

## Public Pages

- / — Landing page and getting-started guide
- /marketplace — Browse and search all available API tools
- /docs — Full API documentation with code examples (JS, Python, Go, cURL)

## API Endpoints (base: /v1)

- GET  /v1/tools                  — List all published tools
- GET  /v1/tools/search?q={query} — Search tools by keyword
- GET  /v1/tools/search?q={query}&mode=semantic — Semantic search
- GET  /v1/tools/search?q={query}&mode=agentic  — Agentic search (LLM reasoning)
- GET  /v1/tools/:id              — Get tool details
- POST /v1/proxy/:toolId          — Call a tool (requires wallet signature or x402 payment)
- GET  /v1/deposit-address        — Get the vault deposit address
- GET  /v1/balance                — Check account balance (authenticated)
- GET  /v1/skill.md               — Agent integration skill (static reference)
- GET  /v1/supplier-skill.md      — Supplier integration skill (how to list an API)

## Payment

- Tokens: USDC, USDT (on Base L2); USDC (on Solana)
- Methods: Pre-funded balance OR x402 pay-per-request (on-chain, Base L2 or Solana)
- Refund policy: Automatic refund if the upstream API returns an error or times out

## Technical Stack

- Frontend: Next.js 14 (App Router)
- Backend: Node.js / Express
- Blockchain: Base L2 (Ethereum), Solana
- Auth: SIWE (Sign-In With Ethereum)
- Payment protocol: x402

## Contact

Website: https://agenticgateway.io