{
  "generated_at": "2026-04-24T15:01:35.625676+00:00",
  "slug": "slamai-dev-token-holder-reputation",
  "title": "SlamAI \u00b7 Token Holder Reputation Scores",
  "url": "https://slamai.dev/token/holder/reputation",
  "category": "finance",
  "summary": "Returns reputation scores for wallets holding a specific token, calculated at current or specified historical blocks.",
  "seo": {
    "title": "Token Holder Reputation API | x402 Free Access",
    "description": "Get reputation scores for token holders at current or historical blocks. Free access. Base network."
  },
  "use_cases": [
    "Assess holder quality for token distributions",
    "Analyze reputation changes over time",
    "Identify high-reputation holders for rewards"
  ],
  "ideal_buyer": "Token projects, airdrop distributors, and onchain analytics agents needing holder quality metrics.",
  "example_prompt": "Get reputation scores for holders of token 0x1234... at block 18000000",
  "example_request_body": {
    "blockchain": "base",
    "at_block_number": 18000000
  },
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "unknown",
    "median_category_atomic": 0
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0xd85096faec1ac03075667b4c1a1661f5623bf111",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "0",
      "max_timeout_seconds": 300,
      "mime_type": "application/json",
      "description": "Returns reputation scores for one or more wallets holding a token,\nat the current or historical block/timestamp.",
      "verified": false,
      "hints": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "blockchain": {
              "enum": [
                "ethereum",
                "base"
              ],
              "type": "string",
              "required": true,
              "description": "The blockchain network to query."
            },
            "at_timestamp": {
              "type": "string",
              "description": "UTC timestamp for calculating reputation. If both at_block_number and at_timestamp are supplied, at_block_number takes precedence."
            },
            "token_symbol": {
              "type": "string",
              "description": "The token symbol (used if token_address is not supplied)"
            },
            "estimate_cost": {
              "type": "boolean",
              "description": "If true, only the SLAM token cost is returned"
            },
            "token_address": {
              "type": "string",
              "description": "The contract address of the token"
            },
            "at_block_number": {
              "type": "integer",
              "description": "Block number at which to calculate reputation. If omitted, the latest block is used."
            },
            "wallet_addresses": {
              "type": "string",
              "description": "Pipe-delimited list of wallet addresses. Max: 100"
            }
          }
        },
        "output": {
          "status": 200,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "utc": {
                    "type": "string",
                    "description": "UTC timestamp of the snapshot in ISO 8601 format"
                  },
                  "slam": {
                    "type": "number",
                    "format": "double",
                    "description": "SLAM token cost for this API call"
                  },
                  "block": {
                    "type": "integer",
                    "format": "int32",
                    "description": "Block number for the reputation snapshot"
                  },
                  "chain": {
                    "type": "string",
                    "description": "Blockchain network name (e.g., 'base')"
                  },
                  "holders": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "token": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "description": "Full name of the token"
                            },
                            "symbol": {
                              "type": "string",
                              "description": "Token symbol"
                            },
                            "address": {
                              "type": "string",
                              "description": "Token contract address"
                            }
                          }
                        },
                        "wallet": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "nullable": true,
                              "description": "Optional display name for contract wallets"
                            },
                            "labels": {
                              "type": "string",
                              "nullable": true,
                              "description": "Labels for the wallet if it is a contract (e.g., 'DeFi', 'DEX')"
                            },
                            "address": {
                              "type": "string",
                              "description": "The wallet address"
                            }
                          }
                        },
                        "reputation": {
                          "type": "object",
                          "properties": {
                            "raw": {
                              "type": "number",
                              "format": "double",
                              "nullable": true,
                              "description": "Optional numeric reputation score"
                            },
                            "tier": {
                              "type": "string",
                              "description": "Reputation rating as a letter grade (e.g., 'A-', 'B')"
                            },
                            "weight": {
                              "type": "number",
                              "format": "double",
                              "nullable": true,
                              "description": "Optional weighting of this token\u2019s reputation in the wallet\u2019s composite score"
                            }
                          }
                        }
                      }
                    },
                    "description": "List of holder reputation records matching the query"
                  }
                }
              }
            }
          },
          "description": "OK"
        }
      }
    }
  ],
  "duplicate_cluster_id": "finance-cl-803a04f20556",
  "origin": {
    "slug": "slamai-dev",
    "host": "slamai.dev",
    "title": "slamai.dev",
    "description": "An x402-payable API origin hosted at slamai.dev. No service description available due to server error.",
    "url": "https://slamai.dev"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/slamai-dev-token-holder-reputation",
    "url": "https://x402all.com/resource/slamai-dev-token-holder-reputation",
    "name": "SlamAI \u00b7 Token Holder Reputation Scores",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/slamai-dev-token-holder-reputation",
      "@type": "Offer",
      "price": "0",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "0",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "paymentNetwork",
          "value": "base"
        },
        {
          "@type": "PropertyValue",
          "name": "paymentAsset",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ]
    },
    "sameAs": "https://slamai.dev/token/holder/reputation",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/slamai-dev",
      "url": "https://slamai.dev",
      "name": "slamai.dev",
      "@type": "Organization"
    },
    "identifier": "slamai-dev-token-holder-reputation",
    "description": "Get reputation scores for token holders at current or historical blocks. Free access. Base network.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=slamai-dev-token-holder-reputation",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "finance"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=slamai-dev-token-holder-reputation"
}
