Getting Started

Make your first API request in under 5 minutes. No signup required.

Free Trial (Start Here)

Every IP address gets 5 free API requests per day — no wallet, no signup, no authentication required.

# Intelligence feeds
curl https://apolloai.team/api/agentic-trends
curl https://apolloai.team/api/pain-points

# DeFi data
curl https://apolloai.team/api/defi-yields
curl https://apolloai.team/api/crypto-prices?coin=bitcoin

# OSINT
curl "https://apolloai.team/api/ip-intel?ip=1.1.1.1"

# Web scraping
curl "https://apolloai.team/api/scrape/search?q=AI+agents"

Response headers include x-free-trial: true and x-free-trial-remaining: N so you know how many free requests you have left today.

When free requests run out, endpoints return 402 Payment Required with preview data (2 sample items). Set up x402 payment below for unlimited access.

How x402 Payments Work

x402 is Coinbase's open payment protocol. It uses HTTP status code 402 Payment Required to enable instant, programmatic micropayments. No API keys, no accounts, no subscriptions.

Prerequisites

You need two things:

1. A wallet with USDC on Base — Any EVM wallet works. Get USDC on Coinbase, bridge to Base via Base Bridge, or buy directly on Base.
2. Your wallet's private key — The x402 SDK needs it to sign payment authorizations (EIP-3009 transferWithAuthorization). Funds are only moved when you make a request. Never share your private key with anyone.

🔑 API Key (Easiest)

The fastest way to get unlimited access. Standard Bearer token auth — works with any HTTP client.

# Just add your API key as a Bearer token
curl -H "Authorization: Bearer ak_YOUR_KEY" \
  https://apolloai.team/api/agent-intel

# Works with any language / HTTP library
# Python: requests.get(url, headers={"Authorization": "Bearer ak_..."})
# Node: fetch(url, { headers: { Authorization: "Bearer ak_..." } })

curl -X POST https://apolloai.team/api/keys/signup \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","email":"[email protected]"}'

x402 Crypto Payment (Advanced)

For agents and crypto-native users: pay-per-request with USDC on Base. Fully automatic via SDK.

# For httpx (async) - recommended
pip install "x402[httpx]" eth_account

# OR for requests (sync)
pip install "x402[requests]" eth_account

# In your terminal (or .env file)
export EVM_PRIVATE_KEY="0xYOUR_PRIVATE_KEY_HERE"

import os
from eth_account import Account
from x402.mechanisms.evm import EthAccountSigner
from x402.client.httpx import x402_httpx_client

# Create wallet signer
account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
signer = EthAccountSigner(account)

# Create x402-enabled HTTP client
client = x402_httpx_client(signer)

# Make request — payment is handled automatically!
response = client.get("https://apolloai.team/api/agent-intel")
data = response.json()

print(f"Opportunities found: {data['total_opportunities']}")
for opp in data['top_opportunities'][:3]:
    print(f"  - {opp['name']} ({opp['priority']})")

import os
from eth_account import Account
from x402.mechanisms.evm import EthAccountSigner
from x402.client.requests import x402_requests_client

account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
signer = EthAccountSigner(account)
client = x402_requests_client(signer)

# Same API, synchronous
response = client.get("https://apolloai.team/api/pain-points")
print(response.json())

npm install @x402/fetch @x402/evm viem

export EVM_PRIVATE_KEY="0xYOUR_PRIVATE_KEY_HERE"

import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Create wallet signer
const signer = privateKeyToAccount(
  process.env.EVM_PRIVATE_KEY as `0x${string}`
);

// Create x402 client and register payment scheme
const client = new x402Client();
registerExactEvmScheme(client, { signer });

// Wrap fetch with automatic payment handling
const fetchWithPayment = wrapFetchWithPayment(fetch, client);

// Make request — payment handled automatically!
const response = await fetchWithPayment(
  "https://apolloai.team/api/agent-intel"
);
const data = await response.json();

console.log(`Opportunities: ${data.total_opportunities}`);
data.top_opportunities.slice(0, 3).forEach(opp =>
  console.log(`  - ${opp.name} (${opp.priority})`)
);

npm install @x402/axios @x402/evm viem

import { x402Client, wrapAxiosWithPayment } from "@x402/axios";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
import axios from "axios";

const signer = privateKeyToAccount(
  process.env.EVM_PRIVATE_KEY as `0x${string}`
);
const client = new x402Client();
registerExactEvmScheme(client, { signer });

const axiosWithPayment = wrapAxiosWithPayment(axios, client);

const { data } = await axiosWithPayment.get(
  "https://apolloai.team/api/agentic-trends"
);
console.log(data);

go get github.com/coinbase/x402/go

package main

import (
    "fmt"
    "os"
    "github.com/coinbase/x402/go/pkg/x402"
    "github.com/ethereum/go-ethereum/crypto"
)

func main() {
    privateKey, _ := crypto.HexToECDSA(
        os.Getenv("EVM_PRIVATE_KEY")[2:], // strip 0x
    )

    client := x402.NewClient(privateKey)
    resp, _ := client.Get(
        "https://apolloai.team/api/agent-intel",
    )
    fmt.Println(string(resp.Body))
}

Easiest Path: Use the MCP Server

Option 1: Streamable HTTP (Recommended — Zero Install)

Point your MCP client directly at our server. No npm install, no local process. Works with any client supporting Streamable HTTP transport (MCP 2025-03-26).

# MCP endpoint URL:
https://apolloai.team/mcp

# Claude Code / claude mcp add:
claude mcp add apollo --transport http https://apolloai.team/mcp

# Or in Claude Desktop config:
{
  "mcpServers": {
    "apollo": {
      "url": "https://apolloai.team/mcp"
    }
  }
}

Option 2: NPM Package (stdio transport)

# Run directly with npx (no install needed)
npx @apollo_ai/mcp-proxy

# Or install globally
npm install -g @apollo_ai/mcp-proxy

# Claude Desktop config (stdio):
{
  "mcpServers": {
    "apollo": {
      "command": "npx",
      "args": ["@apollo_ai/mcp-proxy"]
    }
  }
}

Both options give your AI assistant 52 tools: intelligence feeds, economic data, crypto, OSINT, DeFi, weather, ML/NLP, Etherscan, developer package intel, web scraping, and more.

Popular Endpoints

Full list: /.well-known/x402 (53 endpoints) • Swagger UI • OpenAPI spec

🆓 Free Trial — 5 Requests/Day, No Signup

Every IP gets 5 free API requests per day — full data, no payment needed, no signup required. Just make a GET request:

# Get FULL data for free (5 requests/day per IP)
curl https://apolloai.team/api/agent-intel

# Response headers include:
# x-free-trial: true
# x-free-trial-remaining: 4
#
# After 5 requests, you'll get a 402 with preview data.
# Set up x402 payment or use an API key for unlimited access.

Try any endpoint right now — no wallet, no SDK, no setup. Your first 5 requests today are on us.

After Free Trial — Two Ways to Pay

Once your 5 daily free requests are used, you have two options:

curl -X POST https://apolloai.team/api/keys/signup \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent"}'
# → Returns ak_... key, ready to use

pip install 'x402[httpx]'
# SDK handles payment automatically

Troubleshooting

Common Issues

Need Help?

• Official x402 Buyer Quickstart (Coinbase docs)
• OpenAPI Spec — import into Postman or Insomnia
• Discovery Document — machine-readable endpoint catalog
• GitHub — MCP server source code + issues

Apollo Intelligence Network • Home • API Docs • Proxy Guide • Discovery