Iris

Analyze a wallet with Iris: on Solana (also a token mint or a program), Ethereum, Base, Arbitrum, Robinhood Chain, BNB Chain, Bitcoin, Tron, dYdX or Noble. The chain is read from the address (0x is Ethereum unless chain says another EVM chain). Costs 1 credit (2 when depth is over 1000), or without an API key $0.05 ($0.10 deep) paid per call with x402; refunded (never settled) if it fails. A token, or a wallet Iris hasn't read recently, can take about a minute. For a wallet: what it is (exchange, MEV bot, drainer, sniper, scam or poisoning wallet, personal wallet...), its risk score, the database's labels on it, its behaviours with example transactions, who sent it its first SOL (Solana), where its money came from and went (largest counterparties, labeled), look-alike (address poisoning) addresses, and the exchanges and mixers it moved money with, with the latest transaction for each (to use with trace_transfer). For a token mint: its creator and the creator's funder, the launch bundle and who funded it, red flags, the wallets in its groups and its top holders. For a program: who can upgrade it, who deployed it, its top callers. Only the latest transactions (depth) are read. Returns a summary and a link to the full view on iriscan.app.

{
  "type": "object",
  "properties": {
    "address": {
      "description": "The address: Solana or Tron base58, 0x (EVM), Bitcoin (bc1, 1 or 3), dydx1 or noble1. On Solana also a token mint or a program.",
      "maxLength": 90,
      "minLength": 26,
      "type": "string"
    },
    "chain": {
      "description": "The chain, when the address's form doesn't say it: an EVM chain for a 0x address (ethereum by default). Read from the address otherwise.",
      "enum": [
        "solana",
        "ethereum",
        "base",
        "arbitrum",
        "robinhood",
        "bsc",
        "bitcoin",
        "tron",
        "dydx",
        "noble"
      ],
      "type": "string"
    },
    "depth": {
      "default": 1000,
      "description": "How many of the most recent transactions to read. Over 1000 is a deep analysis (2 credits, or $0.10 with x402). Smaller is faster: 200 is often enough for a first look.",
      "maximum": 10000,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Follow one transfer through the mixer (Privacy Cash, Cloak, Umbra, encrypt.trade, MagicBlock Private Payments, ShadowWire...), exchange, or instant-swap service (SideShift, ChangeNOW, FixedFloat, SimpleSwap, StealthEX, Changelly...) on its other side, by timing and amount: for a deposit, the withdrawals that match it after; for a withdrawal, the deposits that match it before. Gives the likely wallets with a confidence, and how many transfers of the same amount could also fit (the anonymity set). A swap service pays out in another asset, often on another chain: a deposit into SideShift is matched exactly from SideShift's public record of completed shifts (the coin, network and amount it paid out, and the Solana recipient), any other by value at the prices of the time (1 of N candidates). One-time deposit addresses that sweep to the service count as the service. Give the wallet and the signature (transaction hash) of a transaction where it sent money to, or received money from, a mixer, an exchange or a swap service (analyze_address and get_connections list them). Off Solana: on Tron through an exchange or an instant exchange, on an EVM chain through an instant exchange or a privacy pool (Tornado Cash, Railgun, Privacy Pools), on Bitcoin through a CoinJoin or an instant exchange. The chain is read from the wallet's address (pass chain for an EVM chain other than Ethereum). Costs 1 trace (or 3 pack credits), or without an API key $0.25 paid per call with x402; refunded (never settled) if it fails. Results are leads, not proof.

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "The transfer's chain, when the wallet's address doesn't say it: an EVM chain for a 0x wallet (ethereum by default).",
      "enum": [
        "solana",
        "ethereum",
        "base",
        "arbitrum",
        "robinhood",
        "bsc",
        "bitcoin",
        "tron"
      ],
      "type": "string"
    },
    "counterparty": {
      "description": "Optional: the exchange, swap service or mixer wallet (or pool contract) on the other side, when the transaction moved money with several. Iris picks the one it knows otherwise.",
      "maxLength": 90,
      "type": "string"
    },
    "direction": {
      "description": "Optional, with counterparty: out when the wallet paid it (a deposit), in when it paid the wallet (a withdrawal).",
      "enum": [
        "in",
        "out"
      ],
      "type": "string"
    },
    "signature": {
      "description": "The transaction: a Solana signature (base58), an EVM or Tron transaction hash, or a Bitcoin txid.",
      "maxLength": 90,
      "minLength": 64,
      "type": "string"
    },
    "wallet": {
      "description": "The wallet whose deposit or withdrawal is traced (not the exchange or the mixer).",
      "maxLength": 90,
      "minLength": 26,
      "type": "string"
    }
  },
  "required": [
    "wallet",
    "signature"
  ],
  "additionalProperties": false
}

Find the wallets a token's creator is linked to by money (a Solana token, or a Robinhood Chain or BNB Chain one with chain): wallets it funded, wallets that paid it, wallets with the same funder, among the token's earliest buyers, the wallets handed tokens at launch and its largest holders. Says how much of the supply they bought and hold, with the transactions that link them, and why none were found when none were. Costs 2 credits, or without an API key $0.10 paid per call with x402; refunded (never settled) if it fails. Can take up to two minutes. Results are leads, not proof.

{
  "type": "object",
  "properties": {
    "chain": {
      "default": "solana",
      "description": "robinhood for a Robinhood Chain token (Pons launches), bsc for a BNB Chain one (Flap and four.meme launches).",
      "enum": [
        "solana",
        "robinhood",
        "bsc"
      ],
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "How many candidate wallets to check (early buyers and top holders). Fewer is faster.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "mint": {
      "description": "The token's address: a Solana mint (base58), or a 0x token with chain.",
      "maxLength": 90,
      "minLength": 26,
      "type": "string"
    }
  },
  "required": [
    "mint"
  ],
  "additionalProperties": false
}

Whether a Solana wallet launched or traded memecoins with a launch kit, Proxima (proxima.tools) or BlockX, with the evidence. Proxima: its 5% sell fees (a separate bare transfer after each sell, built with it), its 5% cut of pump.fun creator-fee claims, its receipt round trips (895,880 lamports out, 890,880 back). BlockX: its fee inside each trade (0.4% to 0.8%), its nonce relay funding, cash-outs through nonce accounts created and emptied within seconds, its sweep of their rent. Lists the tokens the wallet launched and the relays tipped, the sells the tool took its fee on, each fee wallet (what it was paid, its balance now, whether it ever sent anything out), the creator-fee claims, and the tree of wallets that funded it, walked up to its root funder with what Iris knows of that root. A token's mint scans its creator. Free with an API key, or without one $0.02 paid per call with x402; never settled if it fails. Can take up to two minutes.

{
  "type": "object",
  "properties": {
    "mint": {
      "description": "Optional: narrow the report to this token (base58 mint).",
      "maxLength": 44,
      "minLength": 32,
      "pattern": "^[1-9A-HJ-NP-Za-km-z]+$",
      "type": "string"
    },
    "wallet": {
      "description": "The Solana wallet (a dev or trader), or a token's mint to scan its creator (base58).",
      "maxLength": 44,
      "minLength": 32,
      "pattern": "^[1-9A-HJ-NP-Za-km-z]+$",
      "type": "string"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

Every counterparty of an address that analyze_address analyzed in the last hour on this account (without an API key: for the x402 payer whose receipt is given): wallets it sent to or received from and the venues it swapped on, with labels, the native coin (SOL, ETH, BTC, TRX...) and stablecoins moved each way, the number of transactions, and the date and signature of its first and last transfer (for trace_transfer). Covers the transactions that analysis read only. For a token: the wallets in its groups (creator, bundlers, insiders, wallets handed supply) and its top holders. Free, from the earlier analysis; run analyze_address first.

{
  "type": "object",
  "properties": {
    "address": {
      "description": "The address analyze_address analyzed.",
      "maxLength": 90,
      "minLength": 26,
      "type": "string"
    },
    "chain": {
      "description": "Optional: the chain it was analyzed on, for a 0x address analyzed on several EVM chains. The latest analysis otherwise.",
      "enum": [
        "solana",
        "ethereum",
        "base",
        "arbitrum",
        "robinhood",
        "bsc",
        "bitcoin",
        "tron",
        "dydx",
        "noble"
      ],
      "type": "string"
    },
    "filter": {
      "default": "all",
      "description": "flagged: threats, sanctioned and mixer counterparties, and look-alike (address poisoning) ones; for a token, its creator, bundlers and insiders. exchange or mixer: only those.",
      "enum": [
        "all",
        "flagged",
        "exchange",
        "mixer"
      ],
      "type": "string"
    },
    "limit": {
      "default": 12,
      "description": "How many to list, largest by value first.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "receipt": {
      "description": "Only without an API key: the receipt analyze_address gave when it was paid with x402.",
      "maxLength": 64,
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

The account's plan and what is left: analyses, traces and pack credits, when the allowance renews, and what each tool costs. Without an API key: what each tool costs per call with x402. Free.

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