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

Endpoints

Public

Internal (X-Internal-Secret required)

Subscription Tiers

Payments accumulate on-chain — multiple sends from the same wallet stack toward the highest tier.

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).

Performance

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:

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?

Payment cost comparison

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.netrate.workers.dev/llms.txt        # full machine-readable spec
GET  https://kta.netrate.workers.dev/status?wallet=  # current tier + tools._unlock hint
GET  https://kta.netrate.workers.dev/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.

Tool tiers

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.

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.

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.

Contact

@elemzir