convez.ai
MCP ServerIntegração & APIsIntermediário
whiteknightonhorse

APIbase — Hub MCP para 618 Ferramentas de API

whiteknightonhorse/APIbase

618 APIs em 1 endpoint MCP. Sem setup. Pagamento por uso em USDC.

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP de produção que expõe 618 ferramentas de API reais através de um único endpoint. Agentes de IA conectam uma vez e acessam dados financeiros (Bloomberg FIGI), regulatórios (SEC XBRL), científicos (DBLP, HuggingFace), governamentais (Census, EPA, FEMA, Congress) e utilitários diversos. Pagamento por chamada em USDC via x402 no Base ou MPP no Tempo.

Instalação

$npx convez-ai whiteknightonhorse/APIbase

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
10
Forks
5
Acompanhando
0
Saúde
57%
Último commit
há 1 dia
Versão
v2.2.0
Issues abertas
52
Contribuidores
2

Casos de uso

  • Agentes que precisam consultar dados financeiros, meteorológicos e de mercado em tempo real
  • Integração de APIs governamentais e científicas em fluxos automatizados
  • Análise de vulnerabilidades em dependências npm/PyPI com busca integrada
  • Consultas estruturadas a datasets públicos (Census, USGS, World Bank, CDC)
  • Automatizar pesquisa em repositórios acadêmicos, modelos ML e bases de CVE

Veredito

APIbase é um agregador maduro e bem-arquitetado de APIs externas para agentes Claude. O modelo de micropagamentos em chain (x402/MPP) é inovador mas exige compreensão de Web3; o catálogo amplo (618 ferramentas) compensa a curva de aprendizado. Recomendado para aplicações que exigem acesso a dados estruturados governamentais, financeiros ou científicos em escala.

README

A tradução para o português deste README ainda está na fila.

APIbase.pro — The API Hub for AI Agents

One MCP endpoint. 618 tools. 191 providers. Pay per call with x402 (USDC on Base) or MPP (USDC on Tempo).

Live Platform | Tool Catalog | MCP Endpoint | Frameworks | Dashboard

Security Audit Deploy License: MIT MCP Registry Smithery MPPScan


Product Demo

https://github.com/user-attachments/assets/9e598d61-b2d0-486c-bd34-f0cb0354d09c

12-slide walkthrough: connect → discover tools → 13-stage pipeline → dual-rail payments → analytics. Full interactive version →


What is APIbase?

Production MCP server that gives AI agents access to 618 real-world API tools through a single endpoint. Agents connect once to https://apibase.pro/mcp and can search flights, get stock quotes, check weather and tides, query US Census and CDC health data, search ML models on HuggingFace, look up World Bank indicators, track streamflow from USGS stations, search 7M+ CS papers on DBLP, generate images, send emails, decode VINs, look up chemical compounds, scan npm/PyPI vulnerabilities, search NIST NVD CVE records, find EV chargers, estimate solar PV output, search art at the Met Museum, look up Dota 2 match stats, get decoded aviation METAR/TAF, look up parsed NOTAMs and PIREPs, batch multiple calls, track usage analytics — and 300+ more tools across 30+ categories.

Built for AI agents, not humans. Auto-registration, zero setup, pay-per-call via x402 USDC micropayments on Base or MPP (Machine Payments Protocol) on Tempo.


Quick Start (30 seconds)

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "apibase": {
      "url": "https://apibase.pro/mcp"
    }
  }
}

Multi-server setup (recommended)

Combine APIbase (real-world APIs) with Playwright (browser) and Context7 (docs):

{
  "mcpServers": {
    "apibase": { "url": "https://apibase.pro/mcp" },
    "playwright": { "command": "npx", "args": ["-y", "@playwright/mcp"] },
    "context7": { "command": "npx", "args": ["-y", "@upstash/context7-mcp"] }
  }
}

With Base MCP (pay from your Base Account)

Base MCP launched May 2026 with native x402 support. APIbase is x402-native on Base mainnet — the two pair cleanly. Base MCP signs payments from your Base Account; APIbase serves 600+ external API tools.

{
  "mcpServers": {
    "base-mcp": { "url": "https://mcp.base.org" },
    "apibase":  { "url": "https://apibase.pro/mcp" }
  }
}

Zero API-key management (Base Account handles auth + signing), zero per-provider signup (APIbase aggregates 191 providers). Full guide: apibase.pro/frameworks#base-mcp.

Via npm (stdio bridge)

{
  "mcpServers": {
    "apibase": {
      "command": "npx",
      "args": ["-y", "apibase-mcp-client"]
    }
  }
}

REST API

# Register and get API key
curl -X POST https://apibase.pro/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-agent", "agent_version": "1.0.0"}'

# Call any tool
curl -X POST https://apibase.pro/api/v1/tools/finnhub.quote/call \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL"}'

Tool Categories (618 tools, 191 providers)

CategoryToolsProvidersExamples
Web Search11Serper, Tavily, Exa, Spider.cloudGoogle search, AI search, semantic search, web scraping
News & Events10NewsData, GDELT, Mastodon, Currents APIGlobal news (65 langs), crypto news, trending
Social7Bluesky, TwitterAPI.ioSearch posts, profiles, feeds (AT Protocol, X/Twitter)
Travel & Flights20Amadeus, Sabre, Aviasales, IRCTC Indian RailwaysFlight search, pricing, status, airports, Indian train schedules/live status
Finance & Stocks17Finnhub, CoinGecko, ECB, FRED, World BankStock quotes, OHLCV, FX rates, economic data, global indicators
Banking Data7FDIC BankFind, IBANAPI, Razorpay IFSCUS bank financials, branch locations, institution search, IBAN validation, Indian IFSC lookup
Company Data8SEC EDGAR, Companies House, GLEIFUS filings + UK registry + global LEI (200+ countries)
Currency Conversion2ExchangeRate-API160+ currencies, real-time conversion
Tax & VAT3VATcomplyEU VAT validation, rates, ECB exchange rates
Maps & Geo7GeoapifyGeocode, routing, POI search, isochrone
Address (US/CA)2GeocodioGeocode, reverse geocode, USPS-standard
Real Estate4Walk Score, US Real EstateWalkability, property listings, details
Entertainment40TMDB, Ticketmaster, RAWG, IGDB, Jikan, Lichess, Chess.com, Met Museum, Rijksmuseum, CMA, OpenDotaMovies, events, games, anime, chess/esports, art collections, Dota 2
Art & Culture5Europeana, ARTIC50M+ EU objects + 120K Chicago artworks
Stock Media3PexelsFree stock photos & videos, commercial use
Music9MusicBrainz, ListenBrainz, RadioBrowser, AudDArtists, albums, radio, song recognition, lyrics
Podcasts7PodcastIndex, Listen NotesSearch 4M+ podcasts, 186M+ episodes, best by genre
Health & Nutrition12USDA, OpenFDA, NIH, CDC, UK FSAFood data, drug safety, supplements, public health datasets, UK food hygiene ratings
Chemistry & Biology16PubChem, RCSB PDB, NCI CACTUS, Materials Project100M+ compounds, 220K+ proteins, 150K+ materials, chemical ID converter
EV Charging & Energy7Open Charge Map, NREL AFDC, NREL PVWatts300K+ EV stations worldwide; US alt-fuel stations (EV/CNG/H2); solar PV output estimation
Fraud Detection4IPQualityScoreIP/email/URL/phone fraud scoring, VPN/proxy/bot detection
Disease Data7disease.sh, WHO GHOCOVID/Influenza global disease statistics, WHO global health data
Clinical Trials3ClinicalTrials.gov577K+ trials, drug research, recruiting
Nutrition Database2FatSecret2.3M+ foods, calories, macros, vitamins
Education & Research9OpenAlex, arXiv, PubMed, CrossRef, DBLPPapers, colleges, DOI lookup, CS bibliography
Jobs & Career23Adzuna, TheirStack, Jooble, Reed, Remotive, Arbeitnow, BLS, ESCO, USAJOBSGlobal job search, UK/EU/remote, salary data, tech stack analysis, US federal civil-service
Legal & Regulatory11Regulations.gov, Federal Register, CourtListener, GOV.UK Content APIUS/UK regulations, court opinions, government publications
Air Quality2IQAir AirVisualAQI, pollutants (PM2.5/O3), 30K+ stations
Weather19WeatherAPI.com, NWS, NOAA, NASA FIRMS, NOAA AWC, CheckWX, AVWXCurrent/forecast, hourly, observations, astronomy, alerts, fire detection, aviation METAR/TAF/SIGMET (raw + decoded JSON), parsed NOTAMs and PIREPs
Space & Astronomy13NASA, JPL, NOAA SWPCAPOD, asteroids, fireballs, solar flares
Translation3Langbly90+ languages, language detection
Sports7API-Sports, BallDontLieFootball (2000+ leagues), NBA, NFL
Holidays & Calendar3Nager.Date, Calendarific230+ countries, national/religious/observance
Image Generation1Stability AIStable Diffusion, 16 style presets
OCR1OCR.spaceText from images/PDFs, 20+ languages
Speech-to-Text3AssemblyAITranscribe audio, 99 languages, diarization
PDF & Documents6API2PDF, ConvertAPIHTML/URL to PDF, DOCX↔PDF, 200+ formats
Email & SMS11Resend, Twilio, TelnyxSend emails, SMS (geo-tiered), voice, phone lookup
Messaging5TelegramSend messages, photos, documents via bot
URL Shortener2Short.ioCustom branded short links + stats
SSL & Domain10WhoisXML, ssl-checker.io, ThreatIntelWHOIS, DNS, SSL, domain reputation, malware check
CVE Vulnerabilities3NIST NVDCVE search, CVSS v3 scores, CWE weakness, CPE product lookup
Barcode & QR4QRServer, UPCitemdbGenerate/read QR, barcode lookup
Business Intel1Hunter.ioCompany emails, enrichment, 50M+ domains
E-commerce12Zinc, Canopy API, Diffbot, ZyteProduct search, Amazon (12 marketplaces), web extraction
Memes & Fun2Imgflip100K+ meme templates, generate captioned meme images
AI Marketing7AIPushAI-optimized pages, visibility scores
World Clock3TimeAPI.ioTimezone conversion, 597 IANA zones
Screenshots1ApiFlashChrome-based URL capture
Domain Registration5NameSiloCheck, buy, manage domains (.com $21)
Infrastructure6CloudflareDNS management, CDN cache, traffic analytics
Browser4BrowserbaseManaged browser sessions, screenshots, scraping
Earthquakes3USGSGlobal seismic data, real-time feeds
Water Data2USGS Water ServicesStreamflow gauge sites, real-time water level & discharge
Tides & Currents2NOAA Tides & CurrentsWater levels, tidal predictions, currents — 3,000+ US stations
Disasters3GDACSUN global disaster alerts (earthquakes, floods, hurricanes, volcanoes)
IP Intelligence2ipapi.isGeolocation, VPN/proxy detection
Vehicle Data9NHTSA, Auto.dev, MarketCheckVIN decoder, recalls, safety ratings, car listings, market data
Country Data2REST CountriesCountry search, ISO code lookup
Food Products2Open Food FactsBarcode lookup, product search (3M+ products)
Test Data1RandomUser.meRandom user profiles for testing
Crypto & DeFi26CoinGecko, Polymarket, HyperliquidPrices, prediction markets, perpetuals
Logistics717TRACK, DHL, ShipEngineMulti-carrier tracking, shipping rates, address validation
Postal Codes4Zippopotam.us, Postcodes.ioGlobal postal lookup (60+ countries), UK postcodes
Public-Domain Books13Free Use Bible API, Gutendex, LibriVox, Tatoeba78K Gutenberg books, 20K LibriVox audio, 1K Bible translations, 13M sentence pairs
Brazilian Gov Data17BrasilAPI, IBGE, BCB SGSCNPJ/CEP/banks/PIX, census/municipalities, SELIC/CDI/IPCA/USD-BRL
EU & UK Gov Data7Eurostat, UK PoliceEU unemployment/inflation/GDP, UK street-level crime
Nordic Statistics3Statistics Sweden (SCB)Sweden population, labour market, national accounts, prices — PXWeb API
Singapore Gov Data4data.gov.sgLive weather/PM2.5/rainfall/taxi
US Cultural Archives3US Library of Congress415K digitized historical items
Platform6APIbase (internal)Usage analytics, tool quality index, batch calls

Full tool catalog with schemas: https://apibase.pro/api/v1/tools


Platform Features

Usage Analytics (Free)

Track your API usage — total calls, cost, cache hit rate, latency, and per-tool breakdown.

# Usage summary
curl -X POST https://apibase.pro/api/v1/tools/account.usage/call \
  -H "Authorization: Bearer ak_live_..." \
  -d '{"period": "7d"}'

# Per-tool breakdown
curl -X POST https://apibase.pro/api/v1/tools/account.tools/call \
  -H "Authorization: Bearer ak_live_..." \
  -d '{"sort": "cost", "limit": 10}'

# Time series (hourly/daily buckets)
curl -X POST https://apibase.pro/api/v1/tools/account.timeseries/call \
  -H "Authorization: Bearer ak_live_..." \
  -d '{"period": "30d", "granularity": "day"}'

Tool Quality Index (Free)

Check tool reliability before calling — uptime, p50/p95 latency, error rate. Updated every 10 minutes.

# Quality metrics for a specific tool
curl -X POST https://apibase.pro/api/v1/tools/platform.tool_quality/call \
  -H "Authorization: Bearer ak_live_..." \
  -d '{"tool_id": "crypto.get_price"}'

# Rankings — find the most reliable tools
curl -X POST https://apibase.pro/api/v1/tools/platform.tool_rankings/call \
  -H "Authorization: Bearer ak_live_..." \
  -d '{"sort": "uptime", "limit": 20}'

Batch API (Free wrapper)

Execute up to 20 tool calls in parallel with a single request. Each sub-call runs the full pipeline independently. You pay only for individual tool calls.

# Via MCP tool
curl -X POST https://apibase.pro/api/v1/tools/platform.call_batch/call \
  -H "Authorization: Bearer ak_live_..." \
  -d '{"calls": [
    {"tool_id": "crypto.get_price", "params": {"coin": "bitcoin"}},
    {"tool_id": "finance.exchange_rates", "params": {"from": "USD", "to": "EUR"}},
    {"tool_id": "country.by_code", "params": {"code": "US"}}
  ]}'

# Via REST endpoint
curl -X POST https://apibase.pro/api/v1/tools/call_batch \
  -H "Authorization: Bearer ak_live_..." \
  -d '{"calls": [...], "max_parallel": 10}'

Predictive Pre-fetching

When an agent calls a tool, the platform can automatically pre-fetch related data into cache. For example, a flight search pre-fetches exchange rates for the destination currency — so when the agent asks for rates next, it's an instant cache hit.

  • Fire-and-forget: does not slow down the original response
  • Controlled by PREFETCH_ENABLED env var (disabled by default)
  • Rules: flight search → exchange rates, real estate → walk score, geocode → country data

How Payment Works

APIbase supports dual payment rails — agents can pay using either protocol:

x402 (USDC on Base)

FieldValue
Protocolx402 (HTTP 402 Payment Required)
TokenUSDC on Base
Wallet0x50EbDa9dA5dC19c302Ca059d7B9E06e264936480
Price range$0.001 – $1.00 per call
SettlementSelf-hosted on-chain facilitator — no third-party SaaS in the payment path. See docs/x402-facilitator.md.

Sovereign payment settlement

APIbase runs its own x402 facilitator in-process: every successful payment is settled by submitting transferWithAuthorization directly on Base via viem. There is no Coinbase CDP, no PayAI, no third-party intermediary in the critical path of a paid request.

  • No vendor lock-in. If any third-party facilitator changes pricing, ToS, or KYC requirements, our service is unaffected.
  • Open architecture. Built on the public @x402/core + @x402/evm SDKs and viem — anyone can fork the pattern. Implementation in src/payments/local-facilitator.ts.
  • Predictable cost. Settlement = fixed Base gas (~$0.0005 per call) instead of opaque per-settle facilitator fees.
  • Fallback retained. PayAI HTTP facilitator stays wired as transparent in-client fallback — single-RPC blips don't drop revenue.

MPP (Machine Payments Protocol)

FieldValue
ProtocolMPP (IETF draft-ryan-httpauth-payment)
TokenUSDC on Tempo (chain 4217)
Wallet0x183fFa1335EB66858EebCb86F651f70632821f8d
USDC contract0x20C000000000000000000000b9537d11c60E8b50
SDKmppx (npm)
Agent setupwallet.tempo.xyz — one link, connected
Discoverympp.dev/services
Price range$0.001 – $1.00 per call

No subscriptions. No minimums. Agent pays only for successful calls. Failed provider calls are auto-refunded.

13-Stage Pipeline

Every tool call passes through:

AUTH → IDEMPOTENCY → CONTENT_NEG → SCHEMA_VALIDATION → TOOL_STATUS →
CACHE → RATE_LIMIT → ESCROW → PROVIDER_CALL →
ESCROW_FINALIZE → LEDGER_WRITE → CACHE_SET → RESPONSE
  • Escrow-first: USDC locked before provider call, refunded on failure
  • Idempotent: same request + same key = same result, no double charges
  • Cache: per-tool TTL (5s for stock prices, 7 days for walkability scores)
  • Fail-closed: Redis down = reject all, no silent degradation

Authentication

MethodHeaderFormat
API KeyAuthorizationBearer ak_live_<32hex>
x402 PaymentX-PaymentBase64 payment receipt
MPP PaymentAuthorizationPayment <credential> (via mppx SDK)

Auto-registration: agents get API keys instantly on first request. No forms, no approval.

MPP Payment Flow (important for agent developers)

MPP uses a challenge–credential–receipt cycle. You MUST follow the full flow:

1. Agent → POST /api/v1/tools/{tool}/call (with Authorization: Bearer <key>)
2. Server → 402 + WWW-Authenticate: Payment id="...", method="tempo", request="..."
3. Agent signs payment on Tempo → retries with Authorization: Payment <credential>
4. Server verifies on-chain → 200 + Payment-Receipt header + tool result

Critical: Each 402 challenge is unique (HMAC-bound to the request URL, amount, and timestamp). You cannot reuse a credential from one challenge on a different endpoint or after expiry. The mppx SDK handles this automatically.

Using mppx SDK (recommended):

import { Mppx, tempo } from 'mppx/client'

// mppx auto-handles the full 402 → pay → retry cycle
const mppx = Mppx.create({
  methods: [tempo({ account: myTempoWallet })],
})

// This single call handles: request → 402 → sign → pay → retry → 200
const response = await fetch('https://apibase.pro/api/v1/tools/nasa.apod/call', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ak_live_<your_key>',  // API key for agent identity
    'X-API-Key': 'ak_live_<your_key>',             // Preserved when mppx replaces Authorization
  },
  body: JSON.stringify({}),
})

Using Tempo CLI:

curl -fsSL https://tempo.xyz/install | bash
tempo wallet login
tempo request https://apibase.pro/api/v1/tools/nasa.apod/call -X POST --json '{}'

Using AgentCash (one command):

# Try any tool instantly
npx agentcash try https://apibase.pro

# Add all APIbase tools to your agent
npx agentcash add https://apibase.pro

Note: When mppx retries with Authorization: Payment, it replaces the original Bearer header. To preserve agent identity, also send your API key via X-API-Key header — the server accepts both.


Error Codes (Agent-Friendly)

Every error response includes machine-readable recovery hints:

{
  "error": "rate_limit_exceeded",
  "error_code": "RATE_LIMIT_EXCEEDED",
  "message": "Too many requests",
  "request_id": "abc123",
  "suggested_action": "retry_after_delay",
  "documentation_url": "https://apibase.pro/frameworks#rest",
  "retry_after": 15
}
HTTPCodesuggested_action
400bad_request / schema_validation_failedfix_request
401unauthorizedfix_request
402payment_requiredadd_payment
404not_founduse_different_tool
429rate_limit_exceededretry_after_delay
502bad_gatewayretry_after_delay
503service_unavailableretry_after_delay

Troubleshooting (Dual-Rail Payments)

"MPP payment verification failed" on x402 requests

Symptom: Agent sends x402 payment (X-Payment header) but gets 400 MPP payment verification failed instead of data.

Root cause: If you use the mppx SDK with default settings, Mppx.create() installs a global fetch() polyfill that intercepts ALL HTTP requests — including x402 ones. When mppx sees a 402 response, it automatically signs an MPP credential and retries, even if the original request was x402. The MPP credential is invalid for x402 → server returns 400.

Fix: Initialize mppx with polyfill: false:

// WRONG — intercepts all fetch() calls including x402
const mppx = await Mppx.create({ wallet });

// CORRECT — only use mppx.fetch() explicitly for MPP payments
const mppx = await Mppx.create({ wallet, polyfill: false });

Then use mppx.fetch() only for MPP payments, and regular fetch() for x402.

Using both payment protocols

APIbase supports dual-rail payments. Each request should use ONE protocol:

ProtocolHeaderWhen to use
x402X-Payment: <signed-payload>Default. Use with Coinbase CDP or PayAI facilitator
MPPAuthorization: Payment <credential>Use with Tempo wallet and mppx SDK

Do NOT send both headers in the same request — both middleware will activate and one will fail.


MCP Discovery

GET  /.well-known/mcp.json              → MCP server metadata (transport, capabilities, tools count)
GET  /.well-known/mcp/server-card.json  → Full tool catalog with schemas (Smithery)
GET  /.well-known/ai-capabilities.json  → AI capabilities manifest (21 categories)
GET  /.well-known/agent.json            → A2A agent card (protocol, auth, payment)
GET  /.well-known/x402-payment.json     → Payment config (network, facilitators, dual-rail)
GET  /.well-known/openapi.json          → OpenAPI 3.1 spec (with x-payment-info)
GET  /ai.txt                            → Plain text AI agent discovery
GET  /llms.txt                          → Concise LLM context
GET  /api/v1/tools                      → Live tool catalog (all 490 tools, JSON schemas)
GET  /health/ready                      → System health check
POST /mcp  prompts/get discover_tools   → Browse tools by category or task (progressive disclosure)
GET  /frameworks                        → Integration guides for 9 frameworks

Progressive disclosure: Instead of loading all 490 tool schemas into context, agents can call the discover_tools prompt to find relevant tools first:

  • discover_tools (no args) → 21 categories with tool counts
  • discover_tools category="travel" → 17 travel tools
  • discover_tools task="check earthquake near Tokyo" → matching tools ranked by relevance

Tool composition hints: Task-based search results include related tool suggestions:

- amadeus.flights.search: Search for real-time flight offers...
  → Related: amadeus.flight_price (Confirm exact pricing), finance.exchange_rates (Convert to local currency)

Integrations

Every framework connects to one endpoint: https://apibase.pro/mcp

PlatformConfigDocs
Claude Desktop / Code"url": "https://apibase.pro/mcp"3 lines JSON
Cursor IDE.cursor/mcp.json → same URL3 lines JSON
Windsurf (Codeium)"serverUrl": "https://apibase.pro/mcp"3 lines JSON
OpenAI Agents SDKMCPServerStreamableHTTP(url=...)Python + TS
LangChain / LangGraphMultiServerMCPClient({"apibase": {...}})Python
Google ADKMcpToolset(StreamableHTTPConnectionParams(...))Python
CrewAImcp_servers=["https://apibase.pro/mcp"]1 line
Microsoft Copilot StudioUI: Actions → Add MCP ServerEnterprise

Full framework guides with code examples →

Registry Listings

RegistryLink
Smitherysmithery.ai/servers/apibase-pro/api-hub
Glamaglama.ai/mcp/servers/whiteknightonhorse/APIbase
MCP Registryio.github.whiteknightonhorse/apibase
PulseMCPpulsemcp.com (auto-synced)
MPPScanmppscan.com

Architecture

  • 16 Docker containers: API, Worker, Outbox, PostgreSQL, Redis, Nginx, Prometheus, Grafana, Loki, Promtail, Alertmanager, exporters
  • Single Hetzner server with automated health checks, graceful shutdown, and 27+ Prometheus alert rules
  • PostgreSQL = source of truth for financial data (append-only ledger)
  • Redis = cache, rate limiting, single-flight deduplication
  • Self-hosted x402 facilitator = on-chain transferWithAuthorization settled by APIbase directly (no third-party HTTP facilitator in the critical path). Details →
  • Fail-closed: any infrastructure failure = reject requests, never pass through

Self-Hosting

Prerequisites

  • Docker 24.0+ with Compose v2.0+
  • 8GB+ RAM (16 containers)
  • Ports: 8880 (Nginx), 3000 (API), 5432 (Postgres), 6379 (Redis) — all internal

Quick Start

git clone https://github.com/whiteknightonhorse/APIbase.git
cd APIbase
cp .env.example .env    # edit: set POSTGRES_PASSWORD, X402_PAYMENT_ADDRESS, provider keys
docker compose build
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

Verify

# Health check (Nginx on 8880)
curl http://localhost:8880/health/ready

# Check all 16 containers
docker compose ps

# View API logs
docker compose logs api --tail 20

See .env.example for all configuration options. Never commit .env to git.

License

MIT

Ver o original no GitHub

Bom para

Relacionados