Documentation

Introduction

The Appolon API lets you screen wallets, manage staking, and monitor activity programmatically. All endpoints return JSON and use standard HTTP status codes.

Base URL:

https://api.appolon.io/v3

Quickstart

Screen your first wallet in three steps:

1. Create an API key in your dashboard.
2. Send a request to the screening endpoint.
3. Read the trust score and risk breakdown.

curl https://api.appolon.io/v3/screen?address=0xABC \
  -H "Authorization: Bearer YOUR_TOKEN"

Authentication

All requests must include a bearer token in the Authorization header. Keep your keys secret and rotate them regularly.

Wallet screening

Returns a trust score from 0–100 plus a breakdown of sanctions, mixer links, bridge hops, and cluster lineage.

GET /v3/screen?address={address}

Response

{
  "address": "0xABC...",
  "score": 72,
  "risk": {
    "sanctions": "low",
    "mixers": "medium",
    "bridges": "watch"
  }
}

Staking

List pools, open positions, and read daily payout history for any connected wallet.

GET /v3/staking/pools
POST /v3/staking/positions

Monitoring

Subscribe to a wallet and receive webhooks when risk signals change.

POST /v3/monitoring/subscribe

Rate limits

Free plans allow 60 requests per minute. Higher tiers raise this limit. Rate-limited responses return status 429.

Errors

• 400 — invalid request
• 401 — missing or invalid token
• 429 — too many requests
• 500 — server error