Wrapped APIs

Call third-party APIs and pay per use in USDC on Algorand. No upstream accounts or API keys needed.

How it works

1

Discover available APIs

Fetch the catalog to see which providers and endpoints are available for your agent.

curl -s https://algopay-sdk-pay-b17a.vercel.app/api/wrapped/md \
  -H "Authorization: Bearer YOUR_API_KEY"
2

Call any endpoint

Send a POST request with the parameters the upstream API expects.

curl -X POST https://algopay-sdk-pay-b17a.vercel.app/api/wrapped/firecrawl/scrape \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "formats": ["markdown"]}'
3

Get the response, pay automatically

The upstream API response is returned directly. The cost is deducted from your wallet in USDC.

{
  "success": true,
  "data": { "...response from the upstream API..." }
}

Available Providers

OpenAI

GPT chat, embeddings, image generation, text-to-speech, and moderation.

8 endpoints

Firecrawl

Web scraping, crawling, and structured data extraction.

4 endpoints

Tavily

AI-optimized web search, extraction, and crawling.

3 endpoints

Google Gemini

Multimodal chat, vision, PDF processing, and embeddings.

6 endpoints

Anthropic

Claude models — chat, vision, document processing.

4 endpoints

DeepSeek

DeepSeek-V3 and R1 for chat, code, and reasoning.

3 endpoints

Exa

AI-native semantic search and content retrieval.

3 endpoints

Brave Search

Independent web search — web, news, images, videos.

5 endpoints

Groq

Ultra-fast LLM inference — Llama, DeepSeek R1, Gemma.

3 endpoints

Replicate

Run thousands of open-source AI models via API.

4 endpoints

Stability AI

Image generation, editing, upscaling, 3D, and audio.

6 endpoints

Deepgram

Speech-to-text, text-to-speech, and text analysis.

3 endpoints

Mistral AI

Mistral Large, Codestral, Magistral reasoning.

4 endpoints

CoinGecko

Cryptocurrency market data — prices, charts, trending.

5 endpoints

Wolfram|Alpha

Computational knowledge — math, science, finance.

3 endpoints

Judge0

Code execution sandbox — run code in 60+ languages.

2 endpoints

Pricing

Every wrapped API call has two cost components:

ComponentDescription
Upstream costThe actual cost of the third-party API call (varies by provider and endpoint)
AlgoPay feeA flat $0.003 per call for most providers. AI model providers use a 15% markup on token costs instead.

Billing and Safety

Wrapped APIs use a charge-on-success model:

  • Your allowance is reserved before the upstream call to prevent overspending
  • If the upstream call fails, your allowance is restored — you're never charged for failed calls
  • High-value calls above your approval threshold return a 202 with an approval URL

Next Steps