{
  "status": "planned",
  "token": {
    "chain": "bsc",
    "chainId": 56,
    "name": "Niu Lai",
    "symbol": "牛来",
    "contract": "0xBEEA1D618e533a387D941F58a7d4c9b7bD377777"
  },
  "holderFilterUsd": {
    "min": 500,
    "max": 100000
  },
  "recommendedPipeline": [
    {
      "step": "holder_snapshot",
      "provider": "Moralis",
      "request": "GET https://deep-index.moralis.io/api/v2.2/erc20/{token}/owners?chain=bsc&order=DESC",
      "output": [
        "owner_address",
        "balance_formatted",
        "usd_value",
        "is_contract",
        "owner_address_label",
        "cursor"
      ]
    },
    {
      "step": "price_context",
      "provider": "DexScreener",
      "request": "GET https://api.dexscreener.com/tokens/v1/bsc/{token}",
      "output": [
        "priceUsd",
        "liquidity.usd",
        "pairAddress",
        "dexId"
      ]
    },
    {
      "step": "wallet_history",
      "provider": "Bitquery",
      "request": "GraphQL EVM(network: bsc) Transfers and DEXTrades for each eligible wallet",
      "output": [
        "Block.Time",
        "Transaction.Hash",
        "Transfer.Amount",
        "Transfer.AmountInUSD",
        "Transfer.Sender",
        "Transfer.Receiver"
      ]
    },
    {
      "step": "airdrop_score",
      "provider": "Worker + D1 or R2",
      "output": [
        "eligible_wallet",
        "score",
        "tier",
        "reason_codes",
        "audit_snapshot"
      ]
    }
  ],
  "requiredSecrets": [
    "MORALIS_API_KEY",
    "BITQUERY_API_KEY"
  ],
  "optionalSecrets": [
    "BSCSCAN_API_KEY",
    "GOLDRUSH_API_KEY"
  ],
  "plannedWorkerRoutes": [
    "/api/niulai/snapshot",
    "/api/niulai/history/:wallet",
    "/api/niulai/score",
    "/api/niulai/export.csv"
  ],
  "scoringInputs": [
    "current_usd_value",
    "first_buy_time",
    "net_tokens_held",
    "buy_count",
    "sell_count",
    "sell_ratio",
    "time_held_hours",
    "contract_or_exchange_label"
  ],
  "guardrail": "Score public wallet behavior only. Do not infer nationality, ethnicity, or other sensitive identity from purchase behavior."
}