{
  "generated_at": "2026-05-11T00:56:48.476130+00:00",
  "slug": "yddkctoq-nx-link-v1-wallets-address-tokens",
  "title": "Yddkctoq \u00b7 Wallets Tokens",
  "url": "https://yddkctoq.nx.link/v1/wallets/{address}/tokens",
  "category": "finance",
  "summary": "Yddkctoq \u00b7 Wallets Tokens \u2014 x402-protected finance API. Pay $0.000100 per call on base. Indexed by x402all.",
  "seo": {
    "title": "Yddkctoq \u00b7 Wallets Tokens \u2014 x402 finance API \u00b7 $0.000100 per call",
    "description": "Yddkctoq \u00b7 Wallets Tokens \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 Tokens",
      "verified": false,
      "hints": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "result"
                  ],
                  "properties": {
                    "result": {
                      "type": "object",
                      "required": [
                        "pagination",
                        "tokens"
                      ],
                      "properties": {
                        "tokens": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "balance",
                              "chain_id",
                              "token_address"
                            ],
                            "properties": {
                              "name": {
                                "type": "string",
                                "description": "The token name"
                              },
                              "prices": {
                                "type": "object",
                                "description": "Price data",
                                "additionalProperties": {
                                  "type": "number"
                                }
                              },
                              "symbol": {
                                "type": "string",
                                "description": "The token symbol"
                              },
                              "balance": {
                                "type": "string",
                                "description": "The token balance as a string"
                              },
                              "chain_id": {
                                "type": "number",
                                "description": "The chain ID of the token"
                              },
                              "decimals": {
                                "type": "number",
                                "description": "The number of decimal places"
                              },
                              "icon_uri": {
                                "type": "string",
                                "description": "The token icon URI"
                              },
                              "price_data": {
                                "type": "object",
                                "properties": {
                                  "price_usd": {
                                    "type": "number",
                                    "description": "The price of the token in USD"
                                  },
                                  "usd_value": {
                                    "type": "number",
                                    "description": "The value of the token balance in USD"
                                  },
                                  "total_supply": {
                                    "type": "number",
                                    "description": "The total supply of the token"
                                  },
                                  "market_cap_usd": {
                                    "type": "number",
                                    "description": "The market cap of the token in USD"
                                  },
                                  "volume_24h_usd": {
                                    "type": "number",
                                    "description": "The volume of the token in USD"
                                  },
                                  "price_timestamp": {
                                    "type": "string",
                                    "description": "The timestamp of the latest price update"
                                  },
                                  "circulating_supply": {
                                    "type": "number",
                                    "description": "The circulating supply of the token"
                                  },
                                  "percent_change_24h": {
                                    "type": "number",
                                    "description": "The percentage change of the token in the last 24 hours"
                                  }
                                },
                                "description": "Price data for the token"
                              },
                              "token_address": {
                                "type": "string",
                                "description": "The contract address of the token"
                              }
                            }
                          },
                          "description": "Array of wallet tokens."
                        },
                        "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": "Wallet tokens retrieved successfully. Returns token data with metadata including pagination information and chain details. Includes token balances, metadata, and price information when available. Results are sorted by the specified criteria (default: USD value descending) and filtered according to the provided parameters."
          },
          "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 pagination parameters are out of range."
          },
          "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": "Wallet not found or no tokens available for the specified wallet address on the given blockchain networks."
          },
          "500": {
            "description": "Internal server error. This may occur due to network connectivity issues, external 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 token 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 token 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": "tokenAddresses",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 50,
              "minItems": 1,
              "description": "Token addresses to filter by. If provided, only tokens with these addresses will be returned."
            },
            "required": false,
            "description": "Token addresses to filter by. If provided, only tokens with these addresses will be returned."
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 20,
              "maximum": 1000,
              "minimum": 1,
              "description": "The number of tokens to return per chain (default: 20, max: 500)."
            },
            "required": false,
            "description": "The number of tokens to return per chain (default: 20, max: 500)."
          },
          {
            "in": "query",
            "name": "page",
            "schema": {
              "type": "integer",
              "default": 1,
              "maximum": 500,
              "minimum": 1,
              "description": "The page number for pagination (default: 1, max: 20)."
            },
            "required": false,
            "description": "The page number for pagination (default: 1, max: 20)."
          },
          {
            "in": "query",
            "name": "metadata",
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string",
              "default": "true",
              "description": "Whether to include token metadata (default: true)."
            },
            "required": false,
            "description": "Whether to include token metadata (default: true)."
          },
          {
            "in": "query",
            "name": "resolveMetadataLinks",
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string",
              "default": "true",
              "description": "Whether to resolve metadata links to fetch additional token information (default: true)."
            },
            "required": false,
            "description": "Whether to resolve metadata links to fetch additional token information (default: true)."
          },
          {
            "in": "query",
            "name": "includeSpam",
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string",
              "default": "false",
              "description": "Whether to include tokens marked as spam (default: false)."
            },
            "required": false,
            "description": "Whether to include tokens marked as spam (default: false)."
          },
          {
            "in": "query",
            "name": "includeNative",
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string",
              "default": "true",
              "description": "Whether to include native tokens (e.g., ETH, MATIC) in the results (default: true)."
            },
            "required": false,
            "description": "Whether to include native tokens (e.g., ETH, MATIC) in the results (default: true)."
          },
          {
            "in": "query",
            "name": "sortBy",
            "schema": {
              "enum": [
                "balance",
                "token_address",
                "token_price",
                "usd_value"
              ],
              "type": "string",
              "default": "usd_value",
              "description": "Field to sort tokens by: 'balance' for token balance, 'token_address' for token address, 'token_price' for token price, 'usd_value' for USD value (default: usd_value)."
            },
            "required": false,
            "description": "Field to sort tokens by: 'balance' for token balance, 'token_address' for token address, 'token_price' for token price, 'usd_value' for USD value (default: usd_value)."
          },
          {
            "in": "query",
            "name": "sortOrder",
            "schema": {
              "enum": [
                "asc",
                "desc"
              ],
              "type": "string",
              "default": "desc",
              "description": "Sort order: 'asc' for ascending, 'desc' for descending (default: desc)."
            },
            "required": false,
            "description": "Sort order: 'asc' for ascending, 'desc' for descending (default: desc)."
          },
          {
            "in": "query",
            "name": "includeWithoutPrice",
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string",
              "default": "true",
              "description": "Whether to include tokens without price data (default: true)."
            },
            "required": false,
            "description": "Whether to include tokens without price data (default: true)."
          }
        ]
      }
    }
  ],
  "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-tokens",
    "url": "https://x402all.com/resource/yddkctoq-nx-link-v1-wallets-address-tokens",
    "name": "Yddkctoq \u00b7 Wallets Tokens",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/yddkctoq-nx-link-v1-wallets-address-tokens",
      "@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}/tokens",
    "@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-tokens",
    "description": "Yddkctoq \u00b7 Wallets Tokens \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-tokens",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "finance"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=yddkctoq-nx-link-v1-wallets-address-tokens",
  "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:02.716403+00:00",
    "warnings": []
  },
  "contract": {
    "route_template": "https://yddkctoq.nx.link/v1/wallets/{address}/tokens",
    "content_type": "application/json",
    "response_schema": {
      "type": "object",
      "required": [
        "result"
      ],
      "properties": {
        "result": {
          "type": "object",
          "required": [
            "pagination",
            "tokens"
          ],
          "properties": {
            "tokens": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "balance",
                  "chain_id",
                  "token_address"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "The token name"
                  },
                  "prices": {
                    "type": "object",
                    "description": "Price data",
                    "additionalProperties": {
                      "type": "number"
                    }
                  },
                  "symbol": {
                    "type": "string",
                    "description": "The token symbol"
                  },
                  "balance": {
                    "type": "string",
                    "description": "The token balance as a string"
                  },
                  "chain_id": {
                    "type": "number",
                    "description": "The chain ID of the token"
                  },
                  "decimals": {
                    "type": "number",
                    "description": "The number of decimal places"
                  },
                  "icon_uri": {
                    "type": "string",
                    "description": "The token icon URI"
                  },
                  "price_data": {
                    "type": "object",
                    "properties": {
                      "price_usd": {
                        "type": "number",
                        "description": "The price of the token in USD"
                      },
                      "usd_value": {
                        "type": "number",
                        "description": "The value of the token balance in USD"
                      },
                      "total_supply": {
                        "type": "number",
                        "description": "The total supply of the token"
                      },
                      "market_cap_usd": {
                        "type": "number",
                        "description": "The market cap of the token in USD"
                      },
                      "volume_24h_usd": {
                        "type": "number",
                        "description": "The volume of the token in USD"
                      },
                      "price_timestamp": {
                        "type": "string",
                        "description": "The timestamp of the latest price update"
                      },
                      "circulating_supply": {
                        "type": "number",
                        "description": "The circulating supply of the token"
                      },
                      "percent_change_24h": {
                        "type": "number",
                        "description": "The percentage change of the token in the last 24 hours"
                      }
                    },
                    "description": "Price data for the token"
                  },
                  "token_address": {
                    "type": "string",
                    "description": "The contract address of the token"
                  }
                }
              },
              "description": "Array of wallet tokens."
            },
            "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": "1e515c5d26b9b329a88d830359d7d330409904d656468d435b116d091dc48b49"
  }
}