API Prices Terms Open Bot
🤖 AI Agent Integration

Let your AI-agent call a restaurant

Book a restaurant. Reschedule the dentist. Qualify 200 leads. Your AI agent makes real phone calls — you get the results. Crypto deposits, open source, no KYC.

⚡ Quick Start

Three steps to your first call. Copy, paste, call.

🔑

1. Connect Wallet

Sign a message with your ETH wallet. Get a JWT token. No KYC, no signup.

💰

2. Deposit $200+

Send ETH, BTC, USDC, or use Stripe. Balance credited in USD. 0% commission on crypto.

📞

3. Make a Call

POST /calls → WebSocket URL. Stream 8kHz μ-law audio. Your agent talks.

# 1. Authenticate with wallet signature
curl -X POST https://phoneout.tel/auth \
  -H "Content-Type: application/json" \
  -d '{"wallet":"0xYOUR_WALLET","signature":"0xSIGNATURE","message":"PhoneOut.Tel auth 1711756800"}'

# → {"token":"eyJhbGci...","tier":"AI-Startup","balance":10000}

# 2. Check rate for a number
curl https://phoneout.tel/rates?to=+14155551234 \
  -H "Authorization: Bearer YOUR_JWT"

# → {"rate_per_min":0.026,"currency":"USD","destination":"US landline"}

# 3. Start a call
curl -X POST https://phoneout.tel/calls \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"to":"+14155551234"}'

# → {"call_id":"ca_7f3a...","ws_url":"wss://phoneout.tel/ws/ca_7f3a...","status":"ringing"}

📋 Endpoints

POST /auth Wallet signature → JWT token (24h)
GET /balance Current balance in USD cents
GET /rates?to=+33... Per-minute rate for destination
POST /calls Start a call → WebSocket URL (or 402 if no balance)
DELETE /calls/:id Hang up an active call
GET /calls Call history with costs and durations
PUT /preferences Configure report delivery (email/Telegram)
GET /preferences Current report delivery settings

💳 Payment Channels

Minimum deposit: $200. Agent chooses any channel. All automated — no human needed.

⟠ ETH

Transfer ETH to our deposit address. Alchemy webhook detects and credits balance automatically.

0% commission

₿ BTC + Lightning

Pay via BTCPay Server invoice. Supports on-chain BTC and Lightning Network.

0% commission

💲 USDC (x402)

HTTP 402 flow. Pay USDC on Base L2. On-chain verification. Instant credit.

0% commission

💳 Stripe

Machine Payments Protocol. Agent pays with a pre-authorized card via Stripe.

~2.9% Stripe fee

📊 Pricing Tiers

Tier upgrades automatically as cumulative deposits grow. Per-country rates based on competitive analysis.

Tier Cumulative Deposit US Landline $/min Best For
AI-Startup $200 – $999 ~$0.030 Try & build
AI-Agent $1,000 – $9,999 ~$0.024 Working agent
AI-Enterprise $10,000+ ~$0.020 Scale

All prices include Twilio Media Streams surcharge ($0.004/min). Balance guard: 15% of deposit is locked permanently as reserve.

🔍 Agent Discovery

Your agent can discover and connect to PhoneOut.Tel automatically. No manual configuration.

📄

OpenAPI 3.1 Spec

Standard API specification. Any agent framework can read this.

/.well-known/openapi.json
🤖

MCP Server Manifest

Model Context Protocol. Claude, GPT, and compatible agents auto-discover this.

/.well-known/mcp.json

🛡️ Security

Built-in Protection

  • Wallet-based auth — ethers.js signature verification → JWT. No passwords.
  • Rate limiting by wallet — sliding window per wallet address, not IP.
  • DNC pre-check — mandatory for US numbers. Blocked server-side.
  • Spam detection — rules (>200 calls/hr → freeze) + Groq AI pattern analysis.
  • On-chain audit trail — daily merkle root on Base L2. Verifiable on Basescan.
  • Non-refundable deposits — no withdrawals. Eliminates money laundering risk.
  • Open source — MIT license. Audit the code yourself.

🔗 Links

📦

GitHub Repository

Source code, smart contracts, and deployment guide.

MIT License
🤖

Support Bot

Balance checks, report config, dispute resolution.

@PhoneOutTelBot