Skip to content

Robocular/frostbyte-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Frostbyte API

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

Links

License

MIT - see LICENSE

Releases

No releases published

Packages

 
 
 

Contributors