Get NFT contract metadata.

GET with contractAddress query param. Include Authorization: SIWE <token> header.

{
  "path": {
    "chainNetwork": "string"
  },
  "query": {
    "contractAddress": "string (required)"
  }
}

Get metadata for a single NFT.

GET with contractAddress and tokenId query params. Include Authorization: SIWE <token> header.

{
  "path": {
    "chainNetwork": "string"
  },
  "query": {
    "contractAddress": "string (required)",
    "tokenId": "string (required)",
    "tokenType": "string (optional)",
    "refreshCache": "boolean (optional)"
  }
}

List NFTs for a contract collection.

GET with contractAddress and optional pagination params. Include Authorization: SIWE <token> header.

{
  "path": {
    "chainNetwork": "string"
  },
  "query": {
    "contractAddress": "string (required)",
    "withMetadata": "boolean (optional)",
    "pageKey": "string (optional)",
    "pageSize": "number (optional)"
  }
}

Get NFTs owned by an address.

GET with owner and optional filters. Include Authorization: SIWE <token> header.

{
  "path": {
    "chainNetwork": "string (for example: eth-mainnet, base-mainnet)"
  },
  "query": {
    "owner": "string (wallet address, required)",
    "contractAddresses": [
      "string (optional, filter contracts)"
    ],
    "withMetadata": "boolean (optional)",
    "pageKey": "string (optional)",
    "pageSize": "number (optional)"
  }
}

Get owners for all NFTs in a contract.

GET with contractAddress and optional pagination/filter params. Include Authorization: SIWE <token> header.

{
  "path": {
    "chainNetwork": "string"
  },
  "query": {
    "contractAddress": "string (required)",
    "withTokenBalances": "boolean (optional)",
    "block": "string (optional)"
  }
}

Get owners for a specific NFT token.

GET with contractAddress and tokenId query params. Include Authorization: SIWE <token> header.

{
  "path": {
    "chainNetwork": "string"
  },
  "query": {
    "contractAddress": "string (required)",
    "tokenId": "string (required)"
  }
}

Node JSON-RPC gateway route for standard eth_* methods plus Alchemy Token API, Transfers API, and Simulation API methods.

POST JSON-RPC body to /{chainNetwork}/v2 with the desired method and params. Include Authorization: SIWE <token> and Content-Type: application/json headers on every request.

{
  "path": {
    "chainNetwork": "string (for example: eth-mainnet, base-mainnet, arb-mainnet)"
  },
  "body": {
    "jsonrpc": "\"2.0\"",
    "id": "number | string",
    "method": "string (for example: eth_blockNumber, eth_getBalance, eth_call, eth_getLogs, eth_getTransactionReceipt, eth_getBlockByNumber, eth_sendRawTransaction, alchemy_getTokenBalances, alchemy_getTokenMetadata, alchemy_getTokenAllowance, alchemy_getAssetTransfers, alchemy_simulateAssetChanges, alchemy_simulateExecution, alchemy_simulateAssetChangesBundle, alchemy_simulateExecutionBundle)",
    "params": "array"
  }
}

Get NFTs owned by wallets across one or more networks.

POST JSON with address/network pairs and optional filters. Include Authorization: SIWE <token> and Content-Type: application/json headers.

{
  "body": {
    "addresses": [
      {
        "address": "string (wallet address)",
        "networks": [
          "string (network slugs)"
        ]
      }
    ],
    "withMetadata": "boolean (optional)",
    "excludeFilters": [
      "string (optional, for example SPAM)"
    ],
    "includeFilters": [
      "string (optional)"
    ],
    "pageKey": "string (optional)",
    "pageSize": "number (optional)"
  }
}

Get NFT contracts held by wallet addresses.

POST JSON with address/network pairs. Include Authorization: SIWE <token> and Content-Type: application/json headers.

{
  "body": {
    "addresses": [
      {
        "address": "string (wallet address)",
        "networks": [
          "string (network slugs)"
        ]
      }
    ],
    "pageKey": "string (optional)",
    "pageSize": "number (optional)"
  }
}

Get raw token balances (without price and metadata).

POST JSON with wallet address/network pairs. Include Authorization: SIWE <token> and Content-Type: application/json headers.

{
  "body": {
    "addresses": [
      {
        "address": "string (wallet address)",
        "networks": [
          "string (network slugs)"
        ]
      }
    ],
    "includeNativeTokens": "boolean (optional)",
    "includeErc20Tokens": "boolean (optional)",
    "pageKey": "string (optional)"
  }
}

Get token balances with metadata and prices across chains.

POST JSON with wallet address/network pairs. Include Authorization: SIWE <token> and Content-Type: application/json headers.

{
  "body": {
    "addresses": [
      {
        "address": "string (wallet address)",
        "networks": [
          "string (network slugs)"
        ]
      }
    ],
    "withMetadata": "boolean (optional)",
    "withPrices": "boolean (optional)",
    "includeNativeTokens": "boolean (optional)",
    "includeErc20Tokens": "boolean (optional)",
    "pageKey": "string (optional)"
  }
}

Get transaction history for wallet addresses across networks (beta).

POST JSON with address/network pairs and optional filtering. Include Authorization: SIWE <token> and Content-Type: application/json headers.

{
  "body": {
    "addresses": [
      {
        "address": "string (wallet address)",
        "networks": [
          "string (network slugs)"
        ]
      }
    ],
    "category": [
      "string (optional categories)"
    ],
    "order": "string (optional: asc | desc)",
    "pageKey": "string (optional)",
    "pageSize": "number (optional)"
  }
}

Get latest token prices by network and contract address.

POST JSON with addresses array. Include Authorization: SIWE <token> and Content-Type: application/json headers.

{
  "body": {
    "addresses": [
      {
        "network": "string (required, for example eth-mainnet)",
        "address": "string (required, token contract address)"
      }
    ]
  }
}

Get latest token prices by symbol.

GET with repeated symbols query params (for example symbols=ETH&symbols=BTC). Include Authorization: SIWE <token> header.

{
  "query": {
    "symbols": [
      "string (required, repeat query param, max 25)"
    ]
  }
}

Get historical prices by symbol or by network/address.

POST JSON body with either symbol or network+address and a time window. Include Authorization: SIWE <token> and Content-Type: application/json headers.

{
  "body": {
    "symbol": "string (optional, use with startTime/endTime)",
    "network": "string (optional, required with address if symbol omitted)",
    "address": "string (optional, required with network if symbol omitted)",
    "startTime": "string | number (required)",
    "endTime": "string | number (required)",
    "interval": "string (optional: 5m | 1h | 1d)",
    "withMarketData": "boolean (optional)"
  }
}