84trust / 100

Tgm Holders

by Nansen in Onchain & crypto

x402 APIPassing, checked 3 h ago

Get "Token God Mode" (TGM) holders data

POST https://api.nansen.ai/api/v1/tgm/holders

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
165 ms typical, 165 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://api.nansen.ai/api/v1/tgm/holders" \
  -H "content-type: application/json" \
  -d '{"aggregate_by_entity":false,"chain":"solana","filters":{"include_smart_money_labels":["30D Smart Trader","Fund"],"ownership_percentage":{"min":0.01},"token_amount":{"min":1000},"value_usd":{"min":10000}},"label_type":"all_holders","token_address":"2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv"}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.nansen.ai%2Fapi%2Fv1%2Ftgm%2Fholders
const res = await pay("https://api.nansen.ai/api/v1/tgm/holders", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"aggregate_by_entity":false,"chain":"solana","filters":{"include_smart_money_labels":["30D Smart Trader","Fund"],"ownership_percentage":{"min":0.01},"token_amount":{"min":1000},"value_usd":{"min":10000}},"label_type":"all_holders","token_address":"2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv"}),
});
console.log(await res.json());

Example input

{
  "aggregate_by_entity": false,
  "chain": "solana",
  "filters": {
    "include_smart_money_labels": [
      "30D Smart Trader",
      "Fund"
    ],
    "ownership_percentage": {
      "min": 0.01
    },
    "token_amount": {
      "min": 1000
    },
    "value_usd": {
      "min": 10000
    }
  },
  "label_type": "all_holders",
  "token_address": "2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv"
}

Example output

{
  "data": [],
  "pagination": {}
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402182 ms$0.05
8 h agoPassed402165 ms$0.05