{
  "generated_at": "2026-05-11T00:56:48.476130+00:00",
  "slug": "yddkctoq-nx-link-v1-tokens-chainid-address-owners",
  "title": "Yddkctoq \u00b7 Tokens Owners",
  "url": "https://yddkctoq.nx.link/v1/tokens/{chainId}/{address}/owners",
  "category": "finance",
  "summary": "Yddkctoq \u00b7 Tokens Owners \u2014 x402-protected finance API. Pay $0.000100 per call on base. Indexed by x402all.",
  "seo": {
    "title": "Yddkctoq \u00b7 Tokens Owners \u2014 x402 finance API \u00b7 $0.000100 per call",
    "description": "Yddkctoq \u00b7 Tokens Owners \u2014 x402-protected finance API. Pay $0.000100 per call on base. Indexed by x402all."
  },
  "use_cases": [],
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "cheap_outlier",
    "ratio": 0.003,
    "median_category_atomic": 30000
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0x1c0cc9813b7c136c8f124cbc3c7acd217e141230",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "100",
      "max_timeout_seconds": 300,
      "mime_type": "application/json",
      "description": "thirdweb API https://api.thirdweb.com - GET Get Owners",
      "verified": false,
      "hints": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "result"
                  ],
                  "properties": {
                    "result": {
                      "type": "object",
                      "required": [
                        "owners",
                        "pagination"
                      ],
                      "properties": {
                        "owners": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "address",
                              "amount"
                            ],
                            "properties": {
                              "amount": {
                                "type": "string",
                                "description": "Token amount owned as a string"
                              },
                              "address": {
                                "type": "string",
                                "description": "Owner wallet address"
                              },
                              "tokenId": {
                                "type": "string",
                                "description": "Token ID for NFTs"
                              }
                            }
                          },
                          "description": "Array of token owners with amounts."
                        },
                        "pagination": {
                          "type": "object",
                          "properties": {
                            "page": {
                              "type": "number",
                              "default": 1,
                              "nullable": true,
                              "description": "Current page number"
                            },
                            "limit": {
                              "type": "number",
                              "default": 20,
                              "nullable": true,
                              "description": "Number of items per page"
                            },
                            "hasMore": {
                              "type": "boolean",
                              "description": "Whether there are more items available"
                            },
                            "totalCount": {
                              "type": "number",
                              "nullable": true,
                              "description": "Total number of items available"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            },
            "description": "Token owners retrieved successfully. Returns owners with pagination information. For ERC-20 tokens, `amount` represents token balance. For NFTs, `amount` represents quantity owned (usually '1' for ERC-721, can be >1 for ERC-1155)."
          },
          "400": {
            "description": "Invalid request parameters."
          },
          "401": {
            "description": "Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage."
          },
          "404": {
            "description": "Token not found or no owners available."
          },
          "500": {
            "description": "Internal server error."
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "chainId",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "examples": [
                1,
                8453,
                137,
                56,
                43114,
                42161,
                10
              ],
              "description": "The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism).",
              "exclusiveMinimum": true
            },
            "required": true,
            "description": "The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism)."
          },
          {
            "in": "path",
            "name": "address",
            "schema": {
              "type": "string",
              "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth)."
            },
            "required": true,
            "description": "A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth)."
          },
          {
            "in": "query",
            "name": "tokenId",
            "schema": {
              "type": "string",
              "nullable": true,
              "description": "Optional token ID for NFT owners. If provided, returns owners of the specific NFT token."
            },
            "required": false,
            "description": "Optional token ID for NFT owners. If provided, returns owners of the specific NFT token."
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "description": "Number of owners to return per page (1-100)."
            },
            "required": false,
            "description": "Number of owners to return per page (1-100)."
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1,
              "description": "Page number for pagination, starting from 1."
            },
            "required": false,
            "description": "Page number for pagination, starting from 1."
          }
        ]
      }
    }
  ],
  "origin": {
    "slug": "yddkctoq-nx-link",
    "host": "yddkctoq.nx.link",
    "url": "https://yddkctoq.nx.link"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/yddkctoq-nx-link-v1-tokens-chainid-address-owners",
    "url": "https://x402all.com/resource/yddkctoq-nx-link-v1-tokens-chainid-address-owners",
    "name": "Yddkctoq \u00b7 Tokens Owners",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/yddkctoq-nx-link-v1-tokens-chainid-address-owners",
      "@type": "Offer",
      "price": "0.0001",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "additionalProperty": [
        {
          "name": "paymentNetwork",
          "@type": "PropertyValue",
          "value": "base"
        },
        {
          "name": "paymentAsset",
          "@type": "PropertyValue",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ],
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "0.000100",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent"
    },
    "sameAs": "https://yddkctoq.nx.link/v1/tokens/{chainId}/{address}/owners",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/yddkctoq-nx-link",
      "url": "https://yddkctoq.nx.link",
      "name": "yddkctoq.nx.link",
      "@type": "Organization"
    },
    "identifier": "yddkctoq-nx-link-v1-tokens-chainid-address-owners",
    "description": "Yddkctoq \u00b7 Tokens Owners \u2014 x402-protected finance API. Pay $0.000100 per call on base. Indexed by x402all.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=yddkctoq-nx-link-v1-tokens-chainid-address-owners",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "finance"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=yddkctoq-nx-link-v1-tokens-chainid-address-owners",
  "callability": {
    "status": "partial",
    "schema_callability": 0.39,
    "source": "facilitator_bazaar",
    "source_confidence": 0.75,
    "match_confidence": 0.4,
    "schema_confidence": 0.5,
    "validated_at": "2026-05-10T23:22:47.851365+00:00",
    "warnings": []
  },
  "contract": {
    "route_template": "https://yddkctoq.nx.link/v1/tokens/{chainId}/{address}/owners",
    "content_type": "application/json",
    "response_schema": {
      "type": "object",
      "required": [
        "result"
      ],
      "properties": {
        "result": {
          "type": "object",
          "required": [
            "owners",
            "pagination"
          ],
          "properties": {
            "owners": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "address",
                  "amount"
                ],
                "properties": {
                  "amount": {
                    "type": "string",
                    "description": "Token amount owned as a string"
                  },
                  "address": {
                    "type": "string",
                    "description": "Owner wallet address"
                  },
                  "tokenId": {
                    "type": "string",
                    "description": "Token ID for NFTs"
                  }
                }
              },
              "description": "Array of token owners with amounts."
            },
            "pagination": {
              "type": "object",
              "properties": {
                "page": {
                  "type": "number",
                  "default": 1,
                  "nullable": true,
                  "description": "Current page number"
                },
                "limit": {
                  "type": "number",
                  "default": 20,
                  "nullable": true,
                  "description": "Number of items per page"
                },
                "hasMore": {
                  "type": "boolean",
                  "description": "Whether there are more items available"
                },
                "totalCount": {
                  "type": "number",
                  "nullable": true,
                  "description": "Total number of items available"
                }
              }
            }
          }
        }
      }
    },
    "examples": [],
    "schema_presence": {
      "path_schema": "unknown",
      "query_schema": "unknown",
      "header_schema": "unknown",
      "request_body_schema": "unknown",
      "response_schema": "declared"
    },
    "contract_hash": "0e40ea922afdb2712333352ba417bc80205ae9157804ff3b13426bd2072c6ddf"
  }
}