Onyx AML

Return allow / review / deny for a counterparty address against your own risk policy, with the reasons named. Use this before every outbound transfer. Checks issuer blacklists (USDT, USDC), sanctions across six EVM chains plus the OFAC list, open scam databases, community reports and behavioural patterns. Costs credit.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Blockchain address (TRON, Ethereum or other EVM, Solana)"
    },
    "amount_usd": {
      "type": "number",
      "description": "Amount you intend to send, in USD. Used only if your policy caps amounts."
    },
    "policy": {
      "type": "object",
      "description": "Optional. Omit for a conservative default that returns review for anything unknown.",
      "properties": {
        "deny_zones": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "review_zones": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "min_age_days": {
          "type": "integer"
        },
        "max_amount_usd": {
          "type": "number"
        }
      }
    }
  },
  "required": [
    "address"
  ]
}

Return the raw risk markers for one address: risk zone, issuer blacklists, sanctions coverage, scam databases, community reports, address age, balance and exchange attribution where known. Use this when you want the facts rather than a decision. Costs credit.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Blockchain address (TRON, Ethereum or other EVM, Solana)"
    }
  },
  "required": [
    "address"
  ]
}

Screen up to 50 addresses in a single call, for example before a mass payout. Priced per address, and only addresses actually screened are charged. Each result carries facts_complete so you can tell whether the behavioural facts finished loading.

{
  "type": "object",
  "properties": {
    "addresses": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Blockchain address (TRON, Ethereum or other EVM, Solana)"
      },
      "maxItems": 50
    }
  },
  "required": [
    "addresses"
  ]
}

Operational safety check for a payment, separate from risk screening. Detects address poisoning (a lookalike planted in your history so it gets copied instead of the real address), contract recipients that would swallow the tokens, and addresses that behave differently on different chains. Pass known_addresses (the counterparties you already use) to enable poisoning detection. In our live-traffic sample this class of loss came up far more often than sanctioned counterparties. Dedicated transaction-security services cover part of it; no AML screening does. Run this together with onyx_decide before every payment.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Blockchain address (TRON, Ethereum or other EVM, Solana)"
    },
    "known_addresses": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Blockchain address (TRON, Ethereum or other EVM, Solana)"
      },
      "maxItems": 200,
      "description": "Addresses you have used before, so a lookalike can be spotted. Strongly recommended."
    }
  },
  "required": [
    "address"
  ]
}

Multi-hop trace of outgoing flows from an address, with attribution where a node is known (exchange labels, deposit addresses). Use it to establish provenance after receiving funds. Costs more than a screening call.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Blockchain address (TRON, Ethereum or other EVM, Solana)"
    }
  },
  "required": [
    "address"
  ]
}

Subscribe to an address. When it enters an issuer blacklist, a sanctions list or a scam database, we POST a signed event to your callback URL. A one-off check cannot warn you about a freeze that has not happened yet. Billed per address per day. The callback must be public https.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Blockchain address (TRON, Ethereum or other EVM, Solana)"
    },
    "callback_url": {
      "type": "string",
      "description": "Public https URL to receive events"
    }
  },
  "required": [
    "address",
    "callback_url"
  ]
}

How much credit your API key has left, and the current prices. Free.

{
  "type": "object",
  "properties": {}
}

Machine-readable payment terms: which asset and network to send, the address, prices per operation, and how to claim an API key from the address you paid from. No account or signup is involved. Free, and works without a key.

{
  "type": "object",
  "properties": {}
}