Skip to content

OzorOwn/frostbyte-api

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
examples
examples
 
 
frostbyte
frostbyte
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
index.d.ts
index.d.ts
 
 
index.js
index.js
 
 
index.mjs
index.mjs
 
 
package.json
package.json
 
 
pyproject.toml
pyproject.toml
 
 

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"

Quick Start

JavaScript / TypeScript

npm install 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 frostbyte-api
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

Links

License

MIT - see LICENSE

About

Official SDK for Frostbyte API — 40+ APIs with one key. IP geolocation, crypto prices, DNS, screenshots, web scraping, AI agent tools, and more.

api-catalog-three.vercel.app

Topics

api screenshot typescript sdk crypto api-gateway geolocation web-scraping ip-geolocation javascript-sdk python-sdk dns-lookup free-api ai-agent

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages