API

POST /insiders

A token's insiders: the early buyers and top holders its creator is linked to by money, each with the payments that link them.

Request

Costs 2 analyses from your plan, or 2 credits ($0.10). Iris takes the token's creator (the fee payer of its first transaction), its earliest buyers and wallets handed tokens at launch, and its largest holders, then walks back each wallet's funding and reads the creator's own transfers.

Field	Type	Meaning
`mint`	`string`	Required. The token's mint address.
`limit`	`integer`	Wallets to check besides the creator, 1 to 100. Default 50.
`depth`	`integer`	Funding hops to walk back from each wallet, 1 to 3. Default 2.

request.sh

1curl -X POST https://iriscan.app/api/insiders \2  -H "Authorization: Bearer $IRIS_KEY" \3  -H "Content-Type: application/json" \4  -d '{ "mint": "Bo9jh3wsmcC2AjakLWzNmKJ3SgtZmXEcSaW7L2FAvUsU" }'

Response

200 OK · response.json (abridged)

1{2  "mint": "Bo9jh3wsmcC2AjakLWzNmKJ3SgtZmXEcSaW7L2FAvUsU",3  "name": "LIBRA",4  "launched_at": "2025-02-14T21:38:02Z",5  "dev": {6    "address": "DefcyKc4yAjRsCLZjdxWuSUzVohXtLna9g22y3pBCm2z",7    "funded_by": [{ "from": "5ndLnEYq…", "to": "DefcyKc4…", "what": "first funding", "sol": 10.89, "signature": "…" }],8    "funded_from": "a busy service wallet",9    "via": null10  },11  "complete": true,12  "insiders": [13    {14      "address": "Gj9esbWVNJyy55SDJzYudMAznewqmW3Xb6GpUakcCNwT",15      "link": "funded_by_dev",16      "link_name": "funded by the dev",17      "confidence": 0.9,18      "path": [{ "from": "DefcyKc4…", "to": "Gj9esbWV…", "what": "tokens", "tokens": 200000000, "signature": "NjmUdbC9…" }],19      "through": null,20      "also": [],21      "via": null,22      "reasons": ["top holder", "got tokens at launch"],23      "fresh": false,24      "first_buy_seconds": 46,25      "bundled": false,26      "bought": 0,27      "spent_sol": 0,28      "received": 200000000,29      "holds": 0.230    }31  ],32  "summary": {33    "insiders": 3,34    "held_share": 0.254,35    "bought_share": 0.7,36    "candidates": 50,37    "checked": 50,38    "by_link": { "funded by the dev": 3 }39  },40  "notes": ["23 wallets were first funded by an exchange or another service: that links no one."]41}

Fields

link	link_name	Means
`funded_by_dev`	funded by the dev	The creator sent it its first SOL, or SOL or the token later.
`sent_to_dev`	sent money to the dev	It funded the creator, or sent it SOL or tokens.
`same_funder`	same funder as the dev	One wallet (through) funded both.
`dev_funded_funder`	funded by a wallet the dev funded	Creator → through → insider.

path: the payments that make the link, the creator's side first, each with its signature. what is first funding, SOL, tokens or stablecoins.
first_buy_seconds, bought, spent_sol and received cover the token's first transactions read; null or 0 for a holder that came later. holds is its share of the supply now.
via: a mixer (Privacy Cash, Cloak) in its funding. Noted, never a link by itself.
complete is false when the time budget ran out: the result covers the summary.checked wallets and is charged. Search again for the rest.

What never makes a link

Exchanges, known services, aggregators, launchpads, mixers and unlabeled wallets busy enough to be a service (a thousand transactions in a few days). Two buyers who withdrew from the same exchange are not linked.

Specific errors

400 “Not a token mint” (refunded).
400 “The token's launch could not be read, so its creator is unknown” (refunded).
400 “limit must be between 1 and 100”, “depth must be between 1 and 3”.
402 no_credits: fewer than 2 analyses and 2 credits left.