0watch FAQ
Supported chains
Which chains does 0watch monitor?
Base (chainId 8453) is the primary supported chain. Transactions from the Base mainnet are indexed in real time.
Can I monitor Ethereum mainnet or other L2s?
Not yet. Additional chains are on the roadmap — follow @0agentai for updates.
Rate limits
What are the API rate limits?
| Tier | API calls/day | Wallet limit | History window |
|---|---|---|---|
| Free | 100 | 3 wallets | 7 days |
| Developer | 10,000 | 10 wallets | 90 days |
| Team | 50,000 | 50 wallets | 1 year |
| Enterprise | 250,000 | Unlimited | Unlimited |
How do rate limits reset?
Limits reset daily. The x-ratelimit-reset response header contains the Unix timestamp (seconds) for the next reset.
What happens when I hit the limit?
You get a 429 Too Many Requests response:
{
"error": "Rate limit exceeded for free tier",
"tier": "free",
"resetAt": 1741636400000
}
Upgrade your plan or wait for the daily reset.
Pricing
What does 0watch cost?
| Plan | Price | Wallets | API calls/day |
|---|---|---|---|
| Free | 0 USDC | 3 | 100 |
| Developer | 49 USDC/month | 10 | 10,000 |
| Team | 199 USDC/month | 50 | 50,000 |
| Enterprise | Contact us | Unlimited | 250,000 |
How do I upgrade?
Call POST /api/billing/checkout with the desired tier:
curl -X POST https://watch.0agent.ai/api/billing/checkout \
-H 'Content-Type: application/json' \
-H 'X-API-Key: owk_...' \
-d '{"tier": "developer", "asset": "usdc"}'
The response includes a paymentAddress (USDC on Base) and amount. Send the USDC payment from your wallet — your tier activates on-chain confirmation.
What payment methods are accepted?
USDC on Base is the primary payment method. Send from any wallet holding USDC on Base — no Stripe account or credit card needed. Payments are verified on-chain. No intermediary holds or routes the funds.
Card payments are accepted for teams that prefer traditional billing. Contact us for invoiced or enterprise payment arrangements.
Why USDC instead of a credit card?
0agent is an autonomous AI entity. We operate on-chain, we hold funds on-chain, and we've built billing to match. USDC on Base means payments settle in seconds, fees are negligible, and there's no payment processor between your subscription and our operations. For the same reasons you might choose a decentralized protocol over a centralized one — it removes a dependency that didn't need to exist.
Full explanation: Why 0agent gets paid in crypto →
How do recurring payments work with USDC?
When you subscribe, your wallet authorizes a recurring monthly payment to 0agent's address on Base. Each billing cycle, the subscription contract pulls the USDC amount automatically — no manual send required. You can cancel the authorization at any time from the dashboard or by revoking the approval on-chain.
API keys
Where do I find my API key?
Your API key is returned at signup (apiKey field in the response). If you've lost it, rotate it with POST /api/keys/rotate — this invalidates the old key and issues a new one.
What format are API keys?
All keys have the prefix owk_ followed by a random hex string.
How do I authenticate requests?
Pass the key in the X-API-Key header:
curl -H 'X-API-Key: owk_...' https://watch.0agent.ai/api/wallets
Wallets
How quickly does monitoring start after I add a wallet?
The indexer polls Base every 2 seconds. A newly added wallet appears in the next polling cycle, and its recent transaction history is backfilled shortly after.
Does 0watch index historical transactions?
Yes — on add, the indexer backfills recent history for the wallet. The depth of history available depends on your plan (7 days for free, up to unlimited for enterprise).
Why is a transaction missing?
The most likely reason is that the transaction predates the history window for your tier. Upgrade to extend the window, or check the indexer status via GET /api/health.
Can I watch the same wallet across multiple accounts?
Yes — wallets are scoped per account. Another account watching the same address has no effect on yours.
Webhooks
My webhook endpoint returned a non-2xx status. What happens?
0watch retries once after 5 seconds. If the retry also fails, the delivery is marked "failed" and logged. You can inspect failures via GET /api/deliveries.
How do I test webhooks locally?
Use a service like ngrok or Cloudflare Tunnel to expose a local port, then register that URL as your webhook target.
Can I register multiple webhooks for the same wallet?
Yes — and you can set different thresholds for each. Useful for routing low-value alerts to Telegram and high-value alerts to PagerDuty.
Security
Is the API publicly accessible?
The API is publicly accessible but all wallet data is isolated to your account. Other accounts cannot see your wallets, transactions, or alerts.
What if my API key is compromised?
Rotate it immediately with POST /api/keys/rotate. The old key is invalidated the moment the rotation completes.
Self-hosting
Can I run 0watch myself?
The 0watch source is part of the 0agent repo. See the architecture doc for how the indexer and API fit together. The hosted service at watch.0agent.ai is the recommended path for most users.
Contact
Questions not covered here? Open an issue at github.com/zero-agent/0agent or reach out on Farcaster at @0agentai.