Frostbyte API

March 5, 2026 · View on GitHub

40+ APIs with one key. IP geolocation, crypto prices, DNS lookup, web scraping, screenshots, AI agent tools, wallets, and more.

# Get your free API key (200 credits, no signup)
curl -X POST https://agent-gateway-kappa.vercel.app/api/keys/create

# Use any of 40+ services
curl https://agent-gateway-kappa.vercel.app/v1/agent-geo/geo/8.8.8.8 \
  -H "Authorization: Bearer gw_your_key"

Public API (No Key Required)

Get your IP address or look up any IP — no signup, no API key:

# Your IP as plain text
curl https://agent-gateway-kappa.vercel.app/ip

# Your IP with geolocation (JSON)
curl https://agent-gateway-kappa.vercel.app/ip/json

# Look up any IP
curl https://agent-gateway-kappa.vercel.app/ip/geo/8.8.8.8

For batch lookups, distance calculations, and 40+ more APIs, get a free API key below.

Quick Start

JavaScript / TypeScript

npm install github:OzorOwn/frostbyte-api

import { Frostbyte } from 'frostbyte-api';

const fb = new Frostbyte('gw_your_key');

// IP Geolocation
const geo = await fb.geo.lookup('8.8.8.8');
console.log(geo.city, geo.country); // Mountain View, US

// Crypto Prices
const btc = await fb.crypto.price('BTC');
console.log(`BTC: $${btc.price}`);

// Take a Screenshot
const screenshot = await fb.screenshot.capture('https://github.com');
// Returns PNG buffer

// DNS Lookup
const dns = await fb.dns.resolve('github.com');
console.log(dns.records);

Python

pip install git+https://github.com/OzorOwn/frostbyte-api.git

from frostbyte import Frostbyte

fb = Frostbyte('gw_your_key')

# IP Geolocation
geo = fb.geo.lookup('8.8.8.8')
print(geo['city'], geo['country'])  # Mountain View, US

# Crypto Prices
btc = fb.crypto.price('BTC')
print(f"BTC: ${btc['price']}")

# Web Scraping
page = fb.scraper.scrape('https://example.com')
print(page['title'])

cURL

# Create a free API key
curl -X POST https://agent-gateway-kappa.vercel.app/api/keys/create
# Returns: {"key": "gw_abc123...", "credits": 200}

# IP Geolocation
curl https://agent-gateway-kappa.vercel.app/v1/agent-geo/geo/8.8.8.8 \
  -H "Authorization: Bearer gw_abc123"

# Crypto Prices
curl https://agent-gateway-kappa.vercel.app/v1/crypto-feeds/prices \
  -H "Authorization: Bearer gw_abc123"

# DNS Lookup
curl https://agent-gateway-kappa.vercel.app/v1/agent-dns/resolve/github.com \
  -H "Authorization: Bearer gw_abc123"

# Screenshot
curl https://agent-gateway-kappa.vercel.app/v1/agent-screenshot/screenshot?url=https://github.com \
  -H "Authorization: Bearer gw_abc123" --output screenshot.png

# Web Scraping
curl -X POST https://agent-gateway-kappa.vercel.app/v1/agent-scraper/scrape \
  -H "Authorization: Bearer gw_abc123" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Check Balance
curl https://agent-gateway-kappa.vercel.app/api/keys/balance \
  -H "Authorization: Bearer gw_abc123"

Available Services

Service	ID	Endpoints	Use Case
IP Geolocation	`agent-geo`	`GET /geo/:ip`, `GET /geo/me`, `POST /geo/batch`	Locate IPs, detect timezone, calculate distance
Crypto Prices	`crypto-feeds`	`GET /prices`, `GET /price/:symbol`	Real-time prices for 40+ tokens
DNS Lookup	`agent-dns`	`GET /resolve/:domain`, `GET /all/:domain`, `GET /whois/:domain`	DNS records, WHOIS, availability
Screenshots	`agent-screenshot`	`GET /screenshot?url=...`	Capture website screenshots as PNG
Web Scraper	`agent-scraper`	`POST /scrape`, `POST /extract`	Extract content from any URL
Crypto Wallet	`agent-wallet`	`POST /wallets/create`, `GET /wallets/:id/balance`	Generate wallets on 9+ chains
Frostbyte Wallet	`frostbyte-wallet`	`POST /wallet/create`, `POST /swap/execute`	Multi-chain wallet + swaps
Code Runner	`agent-coderunner`	`POST /execute`	Run JS/Python/Ruby/Go in sandboxed environment
PDF Generator	`agent-pdfgen`	`POST /pdf/from-html`, `POST /pdf/from-url`	Generate PDFs from HTML/URL/Markdown
Image Processing	`agent-imageproc`	`POST /resize`, `POST /convert`, `POST /crop`	Resize, crop, convert images
URL Shortener	`agent-shorturl`	`POST /shorten`, `GET /urls/:slug/stats`	Shorten URLs with analytics
Paste Bin	`agent-paste`	`POST /pastes`, `GET /pastes/:id`	Store and share text snippets
Key-Value Store	`agent-memory`	`POST /kv/set`, `GET /kv/get`	Persistent key-value storage
Task Queue	`agent-taskqueue`	`POST /tasks/enqueue`, `POST /tasks/dequeue`	Async job processing
Scheduler	`agent-scheduler`	`POST /jobs/create`	Cron-based job scheduling
Webhooks	`agent-webhooks`	`POST /endpoints/create`	Receive and forward webhooks
Event Bus	`agent-eventbus`	`POST /events/publish`	Pub/sub messaging
File Storage	`agent-filestorage`	`POST /files/upload`, `GET /files/:id/download`	Upload and serve files
Log Drain	`agent-logdrain`	`POST /logs`, `GET /logs`	Centralized logging
Secrets Manager	`agent-secrets`	`POST /secrets/set`, `GET /secrets/get`	Encrypted secret storage
Search	`agent-search`	`GET /search?q=...`	Web search API
Data Transform	`agent-transform`	`POST /transform`	JSON/XML/CSV format conversion
LLM Proxy	`agent-llm`	`POST /chat`, `POST /v1/chat/completions`	OpenAI-compatible LLM access
Email	`agent-email`	`POST /send`	Send emails programmatically
Phone/SMS	`agent-phone`	`POST /numbers`, `POST /numbers/:id/send`	Phone numbers + SMS for agents
DeFi Trading	`defi-trading`	`GET /markets`, `GET /positions`	Market data and trading
On-Chain Analytics	`onchain-analytics`	`GET /tokens/:address`, `GET /trending`	Token analytics and trends
Provably Fair Games	`fair-games`	`POST /games/dice`, `POST /games/coinflip`	Verifiable random games
Poison Guard	`poison-guard`	`POST /analyze`	Detect malicious smart contracts
Webhook Inspector	`webhook-inspector`	`POST /new`	Debug incoming webhooks
Domain Registration	`frostbyte-domains`	`GET /domains/search`, `POST /domains/register`	Search and register domains
Contract Deployer	`contract-deployer`	`POST /compile`, `POST /deploy`	Deploy smart contracts
Token Launchpad	`token-launchpad`	`POST /tokens/create`	Launch ERC-20 tokens
Service Registry	`agent-registry`	`POST /services/register`	Register and discover services
Identity	`agent-identity`	`POST /identities/create`	Create and manage agent identities
DeFi MCP	`defi-mcp`	`POST /mcp/tools/call`	MCP-compatible DeFi tools
Monitor	`agent-monitor`	`POST /monitors`	Uptime monitoring with alerts

All services are accessed through the gateway at:

https://agent-gateway-kappa.vercel.app/v1/{service-id}/{endpoint}

Authentication

Three ways to authenticate:

# 1. Bearer token (recommended)
curl -H "Authorization: Bearer gw_your_key" https://agent-gateway-kappa.vercel.app/v1/agent-geo/geo/8.8.8.8

# 2. Query parameter
curl "https://agent-gateway-kappa.vercel.app/v1/agent-geo/geo/8.8.8.8?key=gw_your_key"

# 3. Request body
curl -X POST https://agent-gateway-kappa.vercel.app/v1/agent-scraper/scrape \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "api_key": "gw_your_key"}'

Pricing

	Free	Paid
Credits	200 (on signup)	500 per $1 USDC
Cost per call	Free	~$0.002
Expiry	30 days	90 days
Rate limit	120 req/min	120 req/min

Payment methods: USDC on Base, Monero (XMR), or x402 auto-pay per request.

# Check your balance
curl https://agent-gateway-kappa.vercel.app/api/keys/balance \
  -H "Authorization: Bearer gw_your_key"

# Top up with USDC (after sending USDC to the gateway address)
curl -X POST https://agent-gateway-kappa.vercel.app/api/credits/topup \
  -H "Content-Type: application/json" \
  -d '{"api_key": "gw_your_key", "tx_hash": "0x..."}'

SDK Reference

JavaScript

import { Frostbyte } from 'frostbyte-api';

const fb = new Frostbyte('gw_your_key');

// Or create a key first
const fb = await Frostbyte.create(); // auto-creates a free key

Methods:

// Geo
fb.geo.lookup(ip)          // Lookup single IP
fb.geo.me()                // Your IP info
fb.geo.batch([ips])        // Batch lookup
fb.geo.distance(ip1, ip2)  // Distance between IPs

// Crypto
fb.crypto.prices()         // All prices
fb.crypto.price(symbol)    // Single token price

// DNS
fb.dns.resolve(domain)     // A records
fb.dns.all(domain)         // All record types
fb.dns.whois(domain)       // WHOIS info

// Screenshots
fb.screenshot.capture(url, options)  // options: { width, height, fullPage }

// Scraper
fb.scraper.scrape(url)     // Extract page content
fb.scraper.extract(url, selectors)  // Extract specific elements

// Wallet
fb.wallet.create(chain)    // Create wallet (eth, sol, btc, etc.)
fb.wallet.balance(id)      // Check balance

// Code Runner
fb.code.execute(language, code)  // Run code

// PDF
fb.pdf.fromHtml(html)      // HTML to PDF
fb.pdf.fromUrl(url)        // URL to PDF

// URL Shortener
fb.shorturl.shorten(url)   // Shorten URL
fb.shorturl.stats(slug)    // Get click stats

// Key Management
fb.balance()               // Check credit balance
fb.usage(hours)            // Get usage stats

Python

from frostbyte import Frostbyte

fb = Frostbyte('gw_your_key')

# Or create a key first
fb = Frostbyte.create()  # auto-creates a free key

Methods:

# Geo
fb.geo.lookup(ip)
fb.geo.me()
fb.geo.batch([ips])
fb.geo.distance(ip1, ip2)

# Crypto
fb.crypto.prices()
fb.crypto.price(symbol)

# DNS
fb.dns.resolve(domain)
fb.dns.all(domain)
fb.dns.whois(domain)

# Screenshots
fb.screenshot.capture(url, width=1280, height=720)

# Scraper
fb.scraper.scrape(url)

# Wallet
fb.wallet.create(chain)
fb.wallet.balance(wallet_id)

# Account
fb.balance()
fb.usage(hours=24)

Rate Limits

120 requests per minute per API key
50 requests per day per IP (without key, on free endpoints)
Rate limit headers included in every response:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset

AI Agent Framework Examples

Ready-to-use integration examples for popular frameworks:

Framework	File	Description
OpenAI Function Calling	`examples/openai-function-calling.py`	Use Frostbyte APIs as GPT-4 tools
LangChain	`examples/langchain-tools.py`	Custom LangChain tools with agent executor
CrewAI	`examples/crewai-tools.py`	Multi-agent crew with specialized roles
MCP Server	frostbyte-mcp	13 tools for Claude Desktop, Cursor, Windsurf

License

MIT - see LICENSE