{
  "generated_at": "2026-05-11T00:56:48.476130+00:00",
  "slug": "yddkctoq-nx-link-v1-wallets-address-balance",
  "title": "Yddkctoq \u00b7 Wallets Balance",
  "url": "https://yddkctoq.nx.link/v1/wallets/{address}/balance",
  "category": "finance",
  "summary": "Yddkctoq \u00b7 Wallets Balance \u2014 x402-protected finance API. Pay $0.000100 per call on base. Indexed by x402all.",
  "seo": {
    "title": "Yddkctoq \u00b7 Wallets Balance \u2014 x402 finance API \u00b7 $0.000100 per call",
    "description": "Yddkctoq \u00b7 Wallets Balance \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 Balance",
      "verified": false,
      "hints": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "result"
                  ],
                  "properties": {
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "chainId",
                          "decimals",
                          "displayValue",
                          "name",
                          "symbol",
                          "tokenAddress",
                          "value"
                        ],
                        "properties": {
                          "name": {
                            "type": "string",
                            "description": "The token name (e.g., 'Ether', 'USD Coin')"
                          },
                          "value": {
                            "type": "string",
                            "description": "Raw balance value as string in smallest unit (wei for ETH, etc.)"
                          },
                          "symbol": {
                            "type": "string",
                            "description": "The token symbol (e.g., 'ETH', 'USDC')"
                          },
                          "chainId": {
                            "type": "number",
                            "description": "The blockchain network ID"
                          },
                          "decimals": {
                            "type": "number",
                            "description": "Number of decimal places for the token"
                          },
                          "displayValue": {
                            "type": "string",
                            "description": "Human-readable balance formatted with appropriate decimal places"
                          },
                          "tokenAddress": {
                            "type": "string",
                            "description": "The token contract address. Returns zero address (0x0...0) for native tokens."
                          }
                        }
                      }
                    }
                  }
                }
              }
            },
            "description": "Wallet native balances retrieved successfully. Returns detailed native token balance information for each chain including token metadata and formatted values."
          },
          "400": {
            "description": "Invalid request parameters. This occurs when the wallet address format is invalid, chainId array is empty or exceeds the maximum limit of 50, or chain IDs are invalid."
          },
          "401": {
            "description": "Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage."
          },
          "500": {
            "description": "Internal server error. This may occur due to blockchain connectivity issues, RPC service unavailability, or unexpected server errors."
          }
        },
        "parameters": [
          {
            "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": "chainId",
            "schema": {
              "type": "array",
              "items": {
                "type": "integer"
              },
              "maxItems": 50,
              "minItems": 1,
              "description": "Chain ID(s) to request balance data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137"
            },
            "required": true,
            "description": "Chain ID(s) to request balance data for. You can specify multiple chain IDs by repeating the parameter, up to a maximum of 50. Example: ?chainId=1&chainId=137"
          },
          {
            "in": "query",
            "name": "tokenAddress",
            "schema": {
              "type": "string",
              "description": "The token contract address. Omit for native token (ETH, MATIC, etc.)."
            },
            "required": false,
            "description": "The token contract address. Omit for native token (ETH, MATIC, etc.)."
          }
        ]
      }
    }
  ],
  "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-wallets-address-balance",
    "url": "https://x402all.com/resource/yddkctoq-nx-link-v1-wallets-address-balance",
    "name": "Yddkctoq \u00b7 Wallets Balance",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/yddkctoq-nx-link-v1-wallets-address-balance",
      "@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/wallets/{address}/balance",
    "@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-wallets-address-balance",
    "description": "Yddkctoq \u00b7 Wallets Balance \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-wallets-address-balance",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "finance"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=yddkctoq-nx-link-v1-wallets-address-balance",
  "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:41:46.355778+00:00",
    "warnings": []
  },
  "contract": {
    "route_template": "https://yddkctoq.nx.link/v1/wallets/{address}/balance",
    "content_type": "application/json",
    "response_schema": {
      "type": "object",
      "required": [
        "result"
      ],
      "properties": {
        "result": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "chainId",
              "decimals",
              "displayValue",
              "name",
              "symbol",
              "tokenAddress",
              "value"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "The token name (e.g., 'Ether', 'USD Coin')"
              },
              "value": {
                "type": "string",
                "description": "Raw balance value as string in smallest unit (wei for ETH, etc.)"
              },
              "symbol": {
                "type": "string",
                "description": "The token symbol (e.g., 'ETH', 'USDC')"
              },
              "chainId": {
                "type": "number",
                "description": "The blockchain network ID"
              },
              "decimals": {
                "type": "number",
                "description": "Number of decimal places for the token"
              },
              "displayValue": {
                "type": "string",
                "description": "Human-readable balance formatted with appropriate decimal places"
              },
              "tokenAddress": {
                "type": "string",
                "description": "The token contract address. Returns zero address (0x0...0) for native tokens."
              }
            }
          }
        }
      }
    },
    "examples": [],
    "schema_presence": {
      "path_schema": "unknown",
      "query_schema": "unknown",
      "header_schema": "unknown",
      "request_body_schema": "unknown",
      "response_schema": "declared"
    },
    "contract_hash": "3c132182a47ade547a2131079edeba4bc6e798f11365ee6f21dd311e2a8bd512"
  }
}