Sandbox API — Test with Real Data, Free

The OnChainRisk sandbox tier gives developers a free API key, real endpoints, and real on-chain response data so you can validate schema, build proof-of-concept integrations, and shake out edge cases before committing to a paid plan. Sandbox returns the same JSON field shape as the paid tiers, so code you write here drops in unchanged when you upgrade. Sandbox is for evaluation and integration testing — not for production monitoring, automated alerting, or customer-facing risk decisions.

Sandbox is for

Evaluating the API surface and capabilities before signing up for a paid tier.
Validating response schema and field-shape against real on-chain addresses and transactions.
Integration testing — wiring the API into your application code paths, error handlers, and retry logic.
Building proofs-of-concept and internal demo dashboards that show realistic risk-score output.
Copy-pasting code samples to verify your auth header, content type, and request body shape are correct.
Comparing response latencies and field shapes against a competing vendor before swapping.

Sandbox is NOT for

Production monitoring or customer-facing risk decisions.
High-volume programmatic scoring at scale.
Automated alerting or any workflow with a real SLA.
Any use case where latency or uptime guarantees matter.

30-second quickstart

Register — free, no card required.
Copy your sandbox API key from Dashboard → API keys. One sandbox key per free account.
Paste it into the Node.js or Python sample below and run.

Rate limits

The sandbox tier enforces per-second and per-day request caps sized for evaluation, not production load. Limits are deliberately lower than the Pro ($49/mo) and Business ($249/mo) tiers — high enough to test a real integration end-to-end, low enough to keep the free tier sustainable. See the interactive sandbox docs for the current numeric values — we keep the canonical reference there so this page never goes stale. If you hit a rate limit during testing, wait for the auto-reset window or upgrade to a paid tier for higher throughput and concurrency.

Response policy

Sandbox responses return the same field shape and same JSON schema as the paid tiers, so anything you build against sandbox structures will work unchanged in production after you swap the API key. Data is real on-chain data, not mocked — risk scores, sanctions matches, and counterparty labels all reflect the live index. Large result sets may be truncated, latency is best-effort, and there is no uptime guarantee. Use sandbox to validate the integration and field-shape contract; do not use it as a data source behind a customer-facing surface or anywhere an SLA matters.

Code samples

Endpoint paths below use /v1/<endpoint> as a placeholder — see the sandbox docs for canonical paths and request bodies for each capability.

Node.js (fetch)

const r = await fetch('https://api.onchainrisk.io/v1/<endpoint>', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <YOUR_SANDBOX_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ address: '0x...', network: 'ethereum' }),
})
const data = await r.json()
console.log(data)

Python (requests)

import requests

r = requests.post(
    'https://api.onchainrisk.io/v1/<endpoint>',
    headers={
        'Authorization': 'Bearer <YOUR_SANDBOX_KEY>',
        'Content-Type': 'application/json',
    },
    json={'address': '0x...', 'network': 'ethereum'},
)
print(r.json())

Ready for production?

Sandbox is sized for evaluation. Once you have your integration working, upgrade to a paid tier for production rate limits, multiple API keys, batch upload, and reliable throughput with no truncation on response payloads. Upgrade in the dashboard — the same API key shape, just with the new tier limits attached, so no code changes are needed beyond the key swap.

Free — 10 checks per rolling 24-hour window, dashboard only, no API access.
Pro — $49/month, 1,000 checks/month, 1 API key, 10 req/s.
Business — $249/month, 5,000 checks/month, 10 API keys, 50 req/s, batch upload.

See /blockchain-analytics-api/ for the full API overview and tier comparison.

Resources

Start free — get a sandbox API key API & docs