KTA Oracle - The Most Capable Keeta Network Oracle
19 tools · 5 tiers · 0.4s finality · 100% on-chain · No API key
Real-time KTA price intelligence, on-chain analytics, whale detection, compliance screening, wallet scoring, identity resolution, and the full Keeta Network SDK surface - served as a tiered REST API from Cloudflare's global edge. The only oracle that combines live price data, AI-powered market insights, and production Keeta SDK tooling in a single deployment.
No API key. No email. No KYC. Your Keeta wallet address is the only identity.
Payments are fully on-chain. Tier activation scans on-chain history in under 2 seconds. Every KTA sent from the same wallet accumulates - you're already on the ladder at 0.1 KTA.
→ kta-oracle.top · Tools catalog · Machine-readable spec · Companion: KTA-Social
At a glance
| |
|---|
| Tools | 19 - free through business tier |
| Tiers | 5 - Free, Starter, Social, Pro, Business |
| Settlement | 0.4 seconds - Keeta Network native finality |
| Edge latency | <5ms - served from Cloudflare KV globally |
| Price freshness | 5 minutes - cron-driven, never stale |
| Platforms | Discord · Telegram · Slack · X/Twitter |
| Auth | Keeta wallet address - no API key, no KYC |
| AI insights | On every price alert - payment-network focused |
| Source | 100% open source - MIT licensed |
Endpoints
Public
| Method | Path | Description |
|---|
GET | / | Oracle landing page |
GET | /health | Service health check |
GET | /price | Live KTA/USD price with 1h / 24h / 7d change |
GET | /rate?currency= | KTA rate in any of 160+ fiat currencies with real-time FX conversion |
GET | /whale/alerts?wallet= | Recent large on-chain KTA movements (Starter+ tier required) |
POST | /activate | Scan on-chain history, assign tier, store in KV |
GET | /subscription?wallet= | Tier, expiry, social lifetime status |
Internal (X-Internal-Secret required)
| Method | Path | Description |
|---|
POST | /fx/quote | FX quote between two Keeta tokens |
POST | /payment/send | Initiate KTA payment from oracle wallet |
POST | /verify-payment | Verify on-chain payment for a subscriber |
Subscription Tiers
Payments accumulate on-chain - multiple sends from the same wallet stack toward the highest tier.
| KTA sent | Tier | Tools | Oracle calls | Social alerts | Whale alerts | Duration |
|---|
| 0.1 | Free | 5 | 20 / day | 100 trial | 1 ever | 5 days |
| 10 | Starter | 8 | 60 total | Trial only | 3 / month | 30 days |
| 50 | Social | 8 | 150 / month | Lifetime | Unlimited | 30 days |
| 300 | Pro | 13 | 300 / month | Lifetime | Unlimited | 30 days |
| 600 | Business | 19 | Unlimited | Lifetime | Unlimited | 30 days |
Send KTA to the oracle wallet address (set in wrangler.toml as ORACLE_WALLET in KTA Social). Then call POST /activate with the sender wallet address. The oracle reads full on-chain history and assigns the correct tier immediately.
Tier Progression
Each tier has a natural ceiling. Users typically upgrade when they hit one of these:
- Free → Starter: Free tier lasts 5 days. Whale feed is locked and only 1 whale alert ever fires. Sending 10 KTA total extends access to 30 days, unlocks the live whale feed on
/onboard, adds 3 whale alerts/month, and triples the API quota. Already sent 0.1? Only 9.9 more needed - sends accumulate.
- Starter → Social: Starter alerts expire after 30 days and still count against the 100-alert trial cap. Social (50 KTA total) is where alerts become permanent - social platform alerts never expire even if Oracle access lapses. One on-chain send, lifetime delivery.
- Social → Pro: Users who need compliance tools, wallet scoring, transaction history, or on-chain analytics outgrow Social. Pro (300 KTA total) adds the full analytics suite - built for operators, teams, and builders.
- Pro → Business: Business (600 KTA total) removes all limits - all 19 SDK tools, unlimited API calls, priority processing. Designed for institutions and teams running automated KTA workflows.
Accumulation is the key mechanic: all sends from the same wallet stack toward the highest tier. A user who sent 0.1 KTA is already on the ladder - every subsequent send moves them up without starting over.
Deploy
npm install
npx wrangler deploy
Required secrets - set before deploying:
npx wrangler secret put KEETA_SEED
npx wrangler secret put INTERNAL_SECRET
npx wrangler secret put KTA_SOCIAL_URL
KEETA_SEED is the BIP39 passphrase for the oracle wallet. INTERNAL_SECRET must match the value set in KTA Social. KTA_SOCIAL_URL is only required if not using the Cloudflare service binding (fallback HTTP).
KEETA_ACCOUNT_INDEX is set in wrangler.toml (non-secret, defaults to 0).
| Operation | Latency | Notes |
|---|
API read (/price, /rate, /whale/alerts) | <5ms | Served from Cloudflare edge KV - no origin round-trip |
| Price freshness | 5 min max | Cron fires every 5 minutes, writes to KV |
| FX rate conversion | <1ms after first fetch | Rates cached in KV for 1 hour |
| KTA settlement | 0.4s | Keeta Network native finality - faster than Solana (~400ms avg), Ethereum (~12s), Bitcoin (~10min) |
| Tier activation | ~1–2s total | 0.4s on-chain settlement + chain scan + KV write |
| Whale detection | every hour | Gated to hourly - avoids CPU overrun on the cron |
The cron runs all independent operations in parallel: price fetch, history read, and whale detection run concurrently, keeping each 5-minute cycle well within Cloudflare's 30-second CPU limit.
For a REST/JSON price oracle, sub-5ms edge reads from a globally distributed network is at the ceiling of what HTTP can deliver. There is no faster retrieval path short of embedding the data in a CDN response.
Mobile
The Oracle landing page (/) is fully mobile-responsive - hamburger navigation, fluid layouts, and touch-optimised controls. Tested across viewport widths from 320px.
Native SDK
All on-chain operations are performed natively through the Keeta Network SDK - no third-party APIs:
| Operation | Native method |
|---|
| Whale detection | client.history() + effects.accounts - reads chain directly |
| Tier activation | scanChainTotal() - sums KTA sent from subscriber wallet on-chain |
| FX quotes | FX.Client.getEstimates() - Keeta Anchor FX engine |
| Payment send | UserClient native transfer - 0.4s Keeta finality |
| Price (fallback) | FX.Client.getEstimates() KTA→USDC - Keeta liquidity pools |
The cron fetches live KTA price with a time-boxed 8s timeout and falls back to the last known price from KV - ensuring the cron never hangs regardless of network conditions. The Keeta Anchor SDK is used for on-demand price in HTTP endpoints where cold starts are acceptable.
Stack
- Cloudflare Workers - TypeScript, cron trigger (
*/5 * * * *)
- Keeta Network SDK -
@keetanetwork/keetanet-client, @keetanetwork/anchor (100% native)
- Cloudflare KV - subscription state and price history ring buffer
Why KTA-Oracle?
| Feature | Most MCP servers | KTA-Oracle |
|---|
| Tools available | 1–5 | 19 |
| AI-powered reasoning on every response | ✗ | ✓ |
| Tiered subscriptions + on-chain payments | ✗ | ✓ |
| Agent-specific onboarding (autonomous) | ✗ | ✓ |
| AML + compliance tools | ✗ | ✓ |
| Production SDK code snippets | ✗ | ✓ |
| Rate limiting + abuse protection | ✗ | ✓ |
| Listed on 5+ marketplaces | ✗ | ✓ |
Payment cost comparison
| SWIFT wire - $50,000 | Keeta Network - $50,000 |
|---|
| Fee | ~$1,050 | $75 |
| Speed | 3–5 business days | 0.4 seconds |
14× cheaper · 1,080,000× faster · same global finality
AI Integration
KTA Oracle exposes 19 SDK tools accessible through KTA Social at /tools. AI agents can connect via the REST endpoints or the SSE stream at /stream?wallet=. See the full integration guide at /guide on the KTA Social deployment.
Agent quick-start
GET https://kta-oracle.top/llms.txt # full machine-readable spec
GET https://kta-oracle.top/status?wallet= # current tier + tools._unlock hint
GET https://kta-oracle.top/stream?wallet= # SSE live price feed
Every /status response includes a tools._unlock object showing: how many tools are available now, how many are locked, and exactly how much KTA is needed to unlock the next tier's tools. Agents can use this to autonomously discover upgrade paths.
| Tier | Tools | Adds |
|---|
| Free (0.1 KTA) | 5 | /price, /rate, /register, /status, /stream |
| Starter (10 KTA) | 8 | /whale/alerts, AI insights, portfolio calc |
| Social (50 KTA) | 8 | Same endpoints + lifetime social alerts |
| Pro (300 KTA) | 13 | /wallet/history, /wallet/score, /compliance/screen, /analytics/network, /network/health |
| Business (600 KTA) | 19 | /identity/resolve, /kyc/verify, /certificate/manage, /container/seal, /batch/build, /permissions/manage |
Model Context Protocol (MCP) & AI Agent Integration
All 19 tools provide standardized JSON schemas for MCP servers, OpenAI function calling, Claude Desktop, and autonomous agents:
- Discovery: Agents fetch
https://kta-oracle.top/llms.txt for machine-readable tool documentation.
- MCP Client Ready: Connectable via standard MCP HTTP/fetch adapters or custom MCP tool wrappers.
- Autonomous Escalation: Agents query
GET /status?wallet= to inspect unlocked tools and calculate remaining KTA needed for tier upgrades.
Alert detection tiers
The Oracle classifies every price move and emits a changeLevel to Social. Social uses this to bypass subscriber frequency timers on large moves.
| Price move | Level | Social cooldown override |
|---|
| < 5% | - | No alert emitted |
| 5–9% | minor | Respects subscriber frequency |
| 10–14% | normal | 4-hour max cooldown |
| 15–19% | notable | 1-hour max cooldown |
| 20–24% | major | 30-minute max cooldown |
| 25%+ | extreme | 5-minute max cooldown |
Troubleshoot
Every feature requires a minimum 0.1 KTA activated wallet. Registration alone does not start alerts or unlock API access - you must send KTA and trigger activation.
| Symptom | Cause | Fix |
|---|
Wallet shows unregistered after sending KTA | Activation not triggered | Call POST /activate (via Social's /activate-oracle) after sending KTA |
| No alerts despite being registered | Trial exhausted or wallet not activated | Check GET /subscription?wallet= - if tier: unregistered, activate first |
| Alerts stopped after some time | Oracle 30-day window expired | Social alerts survive if socialLifetime: true (50+ KTA sent). Renew Oracle by sending more KTA |
| Wrong currency in alerts | FX rate missed a cycle | Re-register with the correct currency. Rates update every cron cycle |
GET /rate returns stale data | KV cache miss on cold start | The cron writes FX data every 5 minutes. Wait one cron cycle and retry |
KV put() limit exceeded | Free plan KV write quota hit | Upgrade to Cloudflare Workers Paid ($5/mo) for 1M writes/month |
| Activation returns 0 KTA | Oracle wallet has no KTA balance | Oracle wallet needs KTA to call getEstimates() from Anchor FX |
429 API quota exceeded | Tier call limit reached | Starter: 60 total. Social: 150/month. Pro: 300/month. Business: unlimited. Upgrade at /checkout |
Check subscription status:
GET /subscription?wallet=keeta_your_wallet
Returns tier, amount, socialLifetime, expiresAt, and activatedAt.
License
MIT - the code is open source. Service access requires a KTA subscription.
Security
See SECURITY.md.
@elemzir