POST /v2/check-address

Aegis full 4-tier verdict (SDN + consensus + 1-hop + BFS) — submit

curl --request POST \
  --url https://api.aegis-kyt.com/v2/check-address \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "TScSLnUodZVsgoGchZspDoimDjDB9bwqVv",
  "network": "TRON"
}
'

import requests

url = "https://api.aegis-kyt.com/v2/check-address"

payload = {
    "address": "TScSLnUodZVsgoGchZspDoimDjDB9bwqVv",
    "network": "TRON"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({address: 'TScSLnUodZVsgoGchZspDoimDjDB9bwqVv', network: 'TRON'})
};

fetch('https://api.aegis-kyt.com/v2/check-address', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}

POST

check-address

Aegis full 4-tier verdict (SDN + consensus + 1-hop + BFS) — submit

curl --request POST \
  --url https://api.aegis-kyt.com/v2/check-address \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "TScSLnUodZVsgoGchZspDoimDjDB9bwqVv",
  "network": "TRON"
}
'

import requests

url = "https://api.aegis-kyt.com/v2/check-address"

payload = {
    "address": "TScSLnUodZVsgoGchZspDoimDjDB9bwqVv",
    "network": "TRON"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({address: 'TScSLnUodZVsgoGchZspDoimDjDB9bwqVv', network: 'TRON'})
};

fetch('https://api.aegis-kyt.com/v2/check-address', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}

Auth: Required · Billing: per your plan (commercial agreement)

Run the full Aegis 4-tier verdict on a single address. Aegis-only — third-party providers run under the hood when the on-chain graph is sparse (opt-in), not as a selectable option.

This endpoint never blocks. It always answers 202 with a check_id; the verdict comes from GET /v2/check-address/{check_id}/result. Billing fires once, on the first successful delivery of that result — not on submit. Polling early, or polling again later, never charges twice.

Request

curl -X POST https://api.aegis-kyt.com/v2/check-address \
  -H "Authorization: Bearer aeg_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TScSLnUodZVsgoGchZspDoimDjDB9bwqVv",
    "network": "TRON"
  }'

Field	Type	Notes
`address`	string	EVM hex (auto-lowercased) or base58 (TRON/BTC/SOL — case preserved)
`network`	string	Case-insensitive. Must be one of .

Optional headers:

Header	Purpose
`Idempotency-Key: <≤64 chars>`	Replay-safe within 24h. Same key + same body → cached response, no charge. Different body → HTTP 409.

Response 202 — accepted

{
  "status": "queued",
  "check_id": "3f8c1e2a-...",
  "address": "TScSLnUodZVsgoGchZspDoimDjDB9bwqVv",
  "network": "TRON",
  "message": "check queued — poll GET /v2/check-address/{check_id}/result",
  "result_url": "/v2/check-address/3f8c1e2a-.../result"
}

Poll result_url every few seconds. Typical completion is 5-90 s; a cold BFS can take longer. Network must be one of — anything else is rejected with HTTP 400 before a job is created.

The verdict

Delivered by GET /v2/check-address/{check_id}/result, which is where the response body and its fields are documented. decision (top-level) is the merchant traffic-light — one of accept · review · reject · unable. Build your accept/block flow on this field:

`decision`	Meaning
`accept`	no risk signals found
`review`	elevated / borderline — your operator decides
`reject`	high risk (sanctions / criminal exposure)
`unable`	no data to assess — do not treat as clean

decision is a probabilistic risk signal, not a command to accept/reject and not legal advice — the final decision and risk are yours. verdict.risk_level / verdict.risk_score give the detail behind the decision; verdict.tier3_applied / tier4_applied show which depth tiers ran (tier4_applied: false may mean too few transactions for BFS — Tier 0+1+2 still executed).

Errors

HTTP	code	Why
400	`bad_request`	malformed address, or `network` not a known chain
400	`unsupported_network`	valid chain, but not one Aegis ingests
401	`missing_or_invalid_key`	Bearer header missing or wrong
402	`insufficient_funds`	USD balance empty — see GET /v2/balance
402	`monthly_cap_exceeded`	monthly spending cap reached (a cap is optional; it can bite while the balance is still healthy)
409	`idempotency_conflict`	same key + different body within 24h

Failures of the check itself surface on the poll, not here — this endpoint only accepts the job.

Get started

Authentication

x402 Endpoints (USDC pay-per-call)

V2 Public API

Webhooks (push events)

Methodology

Reference

Other

POST /v2/check-address

Request

Response 202 — accepted

The verdict

Errors

See also

Authorizations

Headers

Body

Response

​Request

​Response 202 — accepted

​The verdict

​Errors

​See also

Authorizations

Headers

Body

Response

Request

Response 202 — accepted

The verdict

Errors

See also