FAQ

Everything you need to know about OnlyBots — for humans and developers.

General

What is OnlyBots?

OnlyBots is an API that lets AI agents buy video game activation keys autonomously. Browse 30,000+ games across Steam, PlayStation, Xbox, Nintendo, GOG, and more. Pay with USDC on Base chain (instant) or credit card, PayPal, Apple Pay via Coinbase Onramp. No registration, no API keys, no human in the loop.

Who is behind OnlyBots?

Botsignals LLC — a registered company in Delaware, USA.

Address: 1007 N Orange St. 4th Floor 2476, Wilmington, DE 19801

Email: [email protected]

Public payment wallet: 0x0b321A0F1294431347f98e10a2275F23B11BBfFb

Is this legit? Can I trust this site?

Yes. Here's why:

  • Registered LLC — Botsignals LLC is a registered business in Delaware, USA with a public address and email.
  • Onchain payments — every payment and refund is a USDC transaction on Base chain, verifiable by anyone on BaseScan.
  • Public wallet — our payment address is public and immutable. You can verify incoming/outgoing transactions anytime.
  • Live trust metrics — fulfillment rate, refund rate, and average delivery time are published in real-time via our /health endpoint.
  • Authorized supplier — game keys sourced from authorized wholesale distributors, not grey market.
  • 7-day refund window — every purchase includes a dispute period with automatic refunds for delivery failures.
Do I need an account?

No. OnlyBots requires zero registration. No accounts, no API keys, no authentication tokens. Just send HTTP requests (or use MCP tools) and pay. Your wallet address is your identity.

What games are available?

Over 30,000 game keys across 21 platforms (Steam, PSN, Xbox Live, Nintendo eShop, GOG, Epic, EA App, Ubisoft Connect, and more), 12 device types (PC, PS4, PS5, Xbox One, Xbox Series X|S, Nintendo Switch, etc.), and 21 regions (Worldwide, Europe, North America, Asia, and more). The catalog syncs with our supplier every minute.

Payments

What payment methods are accepted?

Option 1: USDC on Base chain — direct ERC-20 transfer. Instant delivery after 5 block confirmations (~10 seconds). This is the fastest option.

Option 2: Credit card, debit card, PayPal, Apple Pay — via Coinbase Onramp. No crypto wallet needed. Coinbase converts your fiat payment to USDC and sends it on-chain. Delivery: 5-15 minutes. Available in 60+ countries.

What is USDC?

USDC (USD Coin) is a stablecoin pegged 1:1 to the US dollar, issued by Circle. 1 USDC = $1.00. It runs on multiple blockchains — OnlyBots uses USDC on Base (Coinbase's L2 network) for low fees and fast transactions.

USDC contract on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

How long does delivery take?
  • USDC payment: Instant — game key delivered in the API response after 5 block confirmations (~10 seconds on Base).
  • Card/PayPal/Apple Pay: 5-15 minutes — Coinbase converts fiat to USDC, sends on-chain, then the key is delivered automatically.
  • Rare edge case: If the supplier needs extra time, the order enters "pending" status. Poll the order endpoint — the key is delivered automatically once ready.
Is the price locked when I start a purchase?

Yes. When you request a price quote, the price is locked for 5 minutes. During that window, the price won't change regardless of exchange rate fluctuations. If the quote expires before payment, you'll get a fresh quote automatically.

What if my payment fails verification?

The API returns detailed diagnostics with every failed payment. Common issues:

  • tx_not_found — Transaction hash not found on Base. Did you send on the right network?
  • wrong_contract — You sent a different token, not USDC.
  • wrong_recipient — USDC was sent to the wrong address.
  • insufficient_amount — Correct token and address, but the amount is too low.
  • tx_failed — Transaction reverted or is still pending.

Each error includes a hint telling you exactly what to do. The most common mistake is sending USDC on Ethereum mainnet instead of Base.

Can I pay with a regular credit card?

Yes. When you initiate a purchase, the API returns a card_payment_url. This link opens a Coinbase Onramp page where you can pay with credit card, debit card, PayPal, Apple Pay, or bank transfer (ACH). No crypto wallet needed — Coinbase handles the conversion to USDC automatically. Available in 60+ countries. Delivery takes 5-15 minutes after payment.

Refunds

What's the refund policy?

Every purchase has a 7-day dispute window. You can request a refund for any of these reasons:

ReasonAuto-approved?Resolution time
not_deliveredYes (instant)Immediate
key_invalidNoWithin 24 hours
key_already_redeemedNoWithin 24 hours
wrong_productNoWithin 24 hours

One refund per order. Sandbox (test) orders are excluded.

How do refunds work?

Refund lifecycle:

  1. pending — refund submitted, awaiting review (key-related issues)
  2. approved — refund approved (instant for not_delivered)
  3. refunded — USDC sent back to your wallet with an on-chain transaction hash

Every refund payout has a refund_tx_hash you can verify on BaseScan. USDC is returned to the same wallet that made the original payment.

What if my key doesn't work?

Submit a refund with reason key_invalid or key_already_redeemed. We verify with our supplier within 24 hours. If confirmed, USDC is returned to your wallet with on-chain proof.

What if I never received my key?

Refunds for not_delivered are auto-approved instantly. No manual review, no waiting. This covers cases where your payment was confirmed on-chain but the key wasn't delivered (e.g., supplier outage).

Security

Is my payment secure?
  • On-chain verification — every payment is verified directly on Base chain (5 block confirmations). No trust required.
  • Double-spend protection — each transaction hash can only be used once. Attempting to reuse a tx_hash returns an error.
  • Price locking — the price is locked for 5 minutes after quote. No bait-and-switch.
  • No stored credentials — we never see your private keys, wallet seed, or card details. USDC payments are peer-to-peer. Card payments go through Coinbase.
Can I verify my transaction?

Yes. Every payment and refund has a transaction hash (tx_hash) that you can look up on BaseScan. Our public payment wallet is 0x0b321A0F...BBfFb — you can see all incoming payments and outgoing refunds.

What are the rate limits?
EndpointLimitWindow
Browse (GET /games, /platforms, etc.)60 requestsper minute
Purchase (POST /purchase)5 requestsper minute
Orders (GET /orders)10 requestsper minute
Refund (POST /refund)3 requestsper minute

Limits are per IP address. Exceeding them returns HTTP 429.

For Developers

How do I integrate with OnlyBots?

Two options:

  • REST API — OpenAPI 3.1 spec, standard HTTP. Base URL: https://api.onlybots.it. No auth. Interactive docs.
  • MCP Server — native tool-use for AI agents. URL: https://mcp.onlybots.it/mcp. Just add the URL to your MCP client.
What's the purchase API flow?
  1. GET /games?q=battlefield — search the catalog
  2. POST /purchase {"game_id": "..."} — returns HTTP 402 with USDC amount, wallet address, and card payment URL
  3. Send USDC on Base to the returned address (or use the card payment URL)
  4. POST /purchase {"game_id": "...", "tx_hash": "0x..."} — returns the game key

Full spec: OpenAPI 3.1 | Markdown docs | agent.json

Is there a sandbox for testing?

Yes. Add "chain": "base-sepolia" to your purchase request. You'll get a mock key (SANDBOX-XXXXX-XXXXX-XXXXX) instead of a real one. Same API, same URL, same flow.

  • Free test USDC: Circle Faucet
  • Free Sepolia ETH: Alchemy Faucet
  • Sandbox orders are auto-cleaned after 7 days
  • Excluded from all production stats and trust metrics
What are the response times?
OperationTypicalP99
Browse games50 ms200 ms
Price quote (402)100 ms300 ms
Payment verification + key1.5 s5 s
Health check100 ms500 ms

Powered by Cloudflare Workers (300+ PoPs globally) with D1 edge database. Target uptime: 99.5%.

MCP (Model Context Protocol)

What is MCP?

MCP (Model Context Protocol) is a standard that lets AI agents use external tools natively — instead of making HTTP calls, the agent gets built-in tools like search_games or confirm_purchase. It's like giving the AI a direct interface to OnlyBots without needing to understand REST APIs, HTTP status codes, or payment protocols.

How do I connect my AI agent via MCP?

Add this URL to your MCP client settings:

https://mcp.onlybots.it/mcp

Works with Claude Desktop, ChatGPT, Cursor, Windsurf, and 500+ other MCP-compatible clients. Zero configuration — just add the URL and the agent gets 7 tools automatically.

What MCP tools are available?
ToolDescription
browse_filtersList all platforms, devices, regions, and languages
search_gamesSmart search with filters — returns best match + alternatives
get_game_detailsFull game info with price and activation instructions
get_price_quoteLock price for 5 minutes, get payment details
confirm_purchaseVerify USDC payment and receive game key
check_orderTrack order status, retrieve key
request_refundSubmit refund claim (7-day window)
REST API vs MCP — which should I use?
  • Use MCP if you're connecting an AI agent (Claude, ChatGPT, Cursor). The agent gets native tools — simpler, no HTTP knowledge needed.
  • Use REST API if you're building a script, bot, app, or any programmatic integration. Full OpenAPI 3.1 spec, standard HTTP.

Both access the same catalog, same prices, same payment flow, same refund policy. They share the same database.