> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Alchemy

The Alchemy connector lets your AI agent act in each user's Alchemy account. Each user connects their own Alchemy API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** API Key
**Categories:** Developer Tools, Databases
**Tools:** 60: 56 read, 4 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ALCHEMY)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Alchemy connection

   In **AgentKit > Connections**, create an Alchemy connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'alchemy'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Alchemy:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'alchemy_block_number_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "alchemy"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Alchemy:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="alchemy_block_number_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Alchemy credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'alchemy_access_list_create',
  toolInput: {
    to: '<to>',
  },
  connector: 'alchemy',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="alchemy_access_list_create",
    tool_input={
        "to": "<to>",
    },
    connection_name="alchemy",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `alchemy_access_list_create`

Create Access List · Read-only

Build an EIP-2930 access list for a transaction (eth_createAccessList).
Returns the access list and the gas used with it.
Use Estimate Gas for a plain gas estimate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `to` (`string`, required): Address the call is sent to. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
- `block` (`string`, optional): Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
- `data` (`string`, optional): Hex-encoded call data: method signature hash and encoded arguments. Example: 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045.
- `from` (`string`, optional): Address the call is sent from. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `gas` (`string`, optional): Gas limit, as hex. Example: 0x5208.
- `gas_price` (`string`, optional): Gas price in wei, as hex. Rarely needed. Example: 0x9184e72a000.
- `value` (`string`, optional): Value to send, in wei, as hex. Example: 0x0.

Example input: `{"to":"<to>"}`

### `alchemy_airdrop_nft_check`

Is Airdrop NFT · Read-only

Check whether an NFT was airdropped (minted to the holder by another sender).
Returns isAirdrop true or false.
Use Get NFTs for Owner with exclude_filters AIRDROPS to hide airdrops.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `token_id` (`string`, required): Token ID, in decimal or hex. Example: 44.

Example input: `{"contract_address":"<contract_address>","token_id":"<token_id>"}`

### `alchemy_asset_transfers_get`

Get Asset Transfers · Read-only

Get the history of native, internal and token transfers to or from an address (alchemy_getAssetTransfers).
Returns transfers with block, hash, from, to, value, asset and category, plus pageKey.
Use Get Wallet Transaction History for full transactions across networks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category` (`array`, required): Transfer types: external, internal, erc20, erc721, erc1155, specialnft. internal is only on Ethereum and Polygon mainnet. Example: ["external", "erc20"].
- `contract_addresses` (`array`, optional): Only token transfers from these contracts (erc20, erc721, erc1155). Example: ["0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48"].
- `exclude_zero_value` (`boolean`, optional): Skip zero-value transfers. Defaults to true. Example: true.
- `from_address` (`string`, optional): Only transfers sent from this address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `from_block` (`string`, optional): First block, hex or latest. Defaults to 0x0. Example: 0x0.
- `max_count` (`string`, optional): Maximum results per page, as hex, up to 0x3e8 (1000). Example: 0x64.
- `order` (`string`, optional): asc (default) or desc by block. Example: desc. One of: `asc`, `desc`.
- `page_key` (`string`, optional): Pagination key from the previous call. Example: 8f1c2d3e-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `to_address` (`string`, optional): Only transfers sent to this address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `to_block` (`string`, optional): Last block, hex or latest. Defaults to latest. Example: latest.
- `with_metadata` (`boolean`, optional): Include block timestamps. Example: true.

Example input: `{"category":["external","erc20"]}`

### `alchemy_balance_get`

Get Balance · Read-only

Get an address's native coin balance (for example ETH) at a block (eth_getBalance).
Returns the balance in wei as hex.
Use Get Token Balances for ERC-20 tokens.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `block` (`string`, optional): Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.

Example input: `{"address":"<address>"}`

### `alchemy_block_by_hash_get`

Get Block by Hash · Read-only

Get a block by its hash (eth_getBlockByHash).
Returns the block header and its transaction hashes, or full transactions.
Use Get Block by Number for a block number or tag.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `block_hash` (`string`, required): Block hash (32 bytes, hex). Example: 0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35.
- `full_transactions` (`boolean`, optional): true returns full transaction objects; false (default) returns only hashes. Example: false.

Example input: `{"block_hash":"<block_hash>"}`

### `alchemy_block_by_number_get`

Get Block by Number · Read-only

Get a block by number or tag (eth_getBlockByNumber).
Returns the block header and its transaction hashes, or full transactions.
Use Get Block by Hash when you have the hash.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `block` (`string`, required): Block number in hex, or a tag: latest, safe, finalized, earliest or pending. Example: latest.
- `full_transactions` (`boolean`, optional): true returns full transaction objects; false (default) returns only hashes. Example: false.

Example input: `{"block":"<block>"}`

### `alchemy_block_by_timestamp_get`

Get Block by Timestamp · Read-only

Find the first block before or after a timestamp on one or more networks.
Returns each network's block number and on-chain timestamp.
Use it to turn dates into block ranges for Get Logs or Get Asset Transfers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `direction` (`string`, required): Return the first block "BEFORE" or "AFTER" the provided timestamp. Example: BEFORE. One of: `BEFORE`, `AFTER`.
- `networks` (`array`, required): Network IDs to query, for example eth-mainnet or base-mainnet. Example: ["eth-mainnet"].
- `timestamp` (`string`, required): Unix or ISO timestamp. Example: 2026-11-01T00:00:00Z.

Example input: `{"direction":"BEFORE","networks":["eth-mainnet"],"timestamp":"<timestamp>"}`

### `alchemy_block_number_get`

Get Block Number · Read-only

Get the latest block number on the connection's network (eth_blockNumber).
Returns the block number as a hex string.
Use Get Block by Number for the block's contents.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `alchemy_block_receipts_get`

Get Block Receipts · Read-only

Get the receipts of every transaction in a block (eth_getBlockReceipts).
Returns a list of receipts with status, gas used and logs.
Use Get Transaction Receipt for one transaction.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `block` (`string`, required): Block number in hex, block hash, or a tag such as latest. Example: latest.

Example input: `{"block":"<block>"}`

### `alchemy_call`

Call Contract · Read-only

Run a read-only contract call at a block without sending a transaction (eth_call).
Returns the hex-encoded return data.
Use Estimate Gas to price a real transaction.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `to` (`string`, required): Address the call is sent to. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
- `block` (`string`, optional): Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.
- `data` (`string`, optional): Hex-encoded call data: method signature hash and encoded arguments. Example: 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045.
- `from` (`string`, optional): Address the call is sent from. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `gas` (`string`, optional): Gas limit, as hex. Example: 0x5208.
- `gas_price` (`string`, optional): Gas price in wei, as hex. Rarely needed. Example: 0x9184e72a000.
- `value` (`string`, optional): Value to send, in wei, as hex. Example: 0x0.

Example input: `{"to":"<to>"}`

### `alchemy_chain_id_get`

Get Chain ID · Read-only

Get the chain ID of the connection's network (eth_chainId).
Returns the chain ID as hex (0x1 for Ethereum mainnet).
Use Get Network Version for the legacy network ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `alchemy_client_version_get`

Get Client Version · Read-only

Get the node client version (web3_clientVersion).
Returns the client version string.
Use it to check the connection works.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `alchemy_code_get`

Get Contract Code · Read-only

Get the bytecode deployed at an address (eth_getCode).
Returns the code as hex, or 0x for a wallet with no code.
Use it to tell contracts from regular accounts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `block` (`string`, optional): Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.

Example input: `{"address":"<address>"}`

### `alchemy_collection_metadata_get`

Get Collection Metadata · Read-only

Get an NFT collection's metadata by OpenSea slug.
Returns name, slug, description, image, external URL and floor price.
Use Get Contract Metadata when you have the contract address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_slug` (`string`, required): OpenSea collection slug. Example: boredapeyachtclub.

Example input: `{"collection_slug":"<collection_slug>"}`

### `alchemy_collections_for_owner_get`

Get Collections for Owner · Read-only

List the NFT collections a wallet holds tokens from.
Returns collections with name, slug, floor price and number owned, plus pageKey.
Use Get Contracts for Owner for a per-contract view.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Wallet address of the NFT owner (an ENS name also works on Ethereum mainnet). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `exclude_filters` (`array`, optional): Exclude NFTs that match these filters: SPAM or AIRDROPS. Example: ["SPAM"].
- `include_filters` (`array`, optional): Only include NFTs that match these filters: SPAM or AIRDROPS. Example: ["AIRDROPS"].
- `page_key` (`string`, optional): Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
- `page_size` (`integer`, optional): Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
- `with_metadata` (`boolean`, optional): true returns NFT metadata; false makes the response smaller and faster. Example: true.

Example input: `{"owner":"<owner>"}`

### `alchemy_contract_metadata_batch_get`

Get Contract Metadata Batch · Read-only

Get metadata for several NFT contracts in one call.
Returns each contract's name, symbol, supply, token type and OpenSea data.
Use Get Contract Metadata for one contract.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_addresses` (`array`, required): Only NFTs from these contract addresses (up to 45). Example: ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"].

Example input: `{"contract_addresses":["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"]}`

### `alchemy_contract_metadata_get`

Get Contract Metadata · Read-only

Get an NFT contract's metadata.
Returns name, symbol, total supply, token type, deployer and OpenSea collection data such as floor price.
Use Get Contract Metadata Batch for several contracts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.

Example input: `{"contract_address":"<contract_address>"}`

### `alchemy_contract_metadata_search`

Search Contract Metadata · Read-only

Search NFT contract metadata (names, descriptions) for a keyword.
Returns matching contracts with their metadata.
Use Get Contract Metadata when you know the address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): String - The search string that you want to search for in contract metadata. Example: bored.

Example input: `{"query":"<query>"}`

### `alchemy_contracts_for_owner_get`

Get Contracts for Owner · Read-only

List the NFT contracts a wallet holds tokens from.
Returns contracts with name, symbol, token type, number owned and OpenSea data, plus pageKey.
Use Get NFTs for Owner for the individual tokens.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Wallet address of the NFT owner (an ENS name also works on Ethereum mainnet). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `exclude_filters` (`array`, optional): Exclude NFTs that match these filters: SPAM or AIRDROPS. Example: ["SPAM"].
- `include_filters` (`array`, optional): Only include NFTs that match these filters: SPAM or AIRDROPS. Example: ["AIRDROPS"].
- `order_by` (`string`, optional): Enum - ordering scheme to use for ordering NFTs in the response. If unspecified, NFTs will be ordered by contract address and token ID. - transferTime: NFTs will be ordered by the time they were transferred into the wallet, with newest NFTs first. NOTE: this ordering is only supported on Ethereum Mainnet and Polygon Mainnet. Example: transferTime. One of: `transferTime`.
- `page_key` (`string`, optional): Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
- `page_size` (`integer`, optional): Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
- `spam_confidence_level` (`string`, optional): Spam confidence level used with the SPAM filter: VERY_HIGH, HIGH, MEDIUM or LOW. Example: HIGH. One of: `VERY_HIGH`, `HIGH`, `MEDIUM`, `LOW`.
- `with_metadata` (`boolean`, optional): true returns NFT metadata; false makes the response smaller and faster. Example: true.

Example input: `{"owner":"<owner>"}`

### `alchemy_fee_history_get`

Get Fee History · Read-only

Get base fees, gas used ratios and priority fee percentiles for a range of recent blocks (eth_feeHistory).
Returns oldestBlock, baseFeePerGas, gasUsedRatio and reward arrays.
Use Get Gas Price for a single current price.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `block_count` (`integer`, required): Number of blocks to return, 1 to 1024. Example: 4.
- `newest_block` (`string`, required): Newest block of the range, as hex or a tag such as latest. Example: latest.
- `reward_percentiles` (`array`, optional): Priority fee percentiles to sample from each block, for example [25, 75]. Example: [25, 75].

Example input: `{"block_count":4,"newest_block":"<newest_block>"}`

### `alchemy_floor_price_get`

Get Floor Price · Read-only

Get an NFT collection's floor price on OpenSea and LooksRare, by contract or slug.
Returns the floor price, currency, collection URL and retrieval time for each marketplace.
Use Get NFT Sales for actual sale prices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_slug` (`string`, optional): OpenSea collection slug. Example: boredapeyachtclub.
- `contract_address` (`string`, optional): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.

Example input: `{}`

### `alchemy_gas_estimate`

Estimate Gas · Read-only

Estimate the gas a transaction would use (eth_estimateGas).
Returns the gas estimate as hex.
Use Get Gas Price or Get Fee History to price it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `to` (`string`, required): Address the call is sent to. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
- `data` (`string`, optional): Hex-encoded call data: method signature hash and encoded arguments. Example: 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045.
- `from` (`string`, optional): Address the call is sent from. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `gas` (`string`, optional): Gas limit, as hex. Example: 0x5208.
- `gas_price` (`string`, optional): Gas price in wei, as hex. Rarely needed. Example: 0x9184e72a000.
- `value` (`string`, optional): Value to send, in wei, as hex. Example: 0x0.

Example input: `{"to":"<to>"}`

### `alchemy_gas_price_get`

Get Gas Price · Read-only

Get the current gas price in wei (eth_gasPrice).
Returns the gas price as hex.
Use Get Fee History or Get Max Priority Fee for EIP-1559 fees.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `alchemy_holder_of_contract_check`

Is Holder of Contract · Read-only

Check whether a wallet holds any NFT from a contract.
Returns isHolderOfContract true or false.
Use Get Owners for Contract to list all holders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `wallet` (`string`, required): String - Wallet address to check for contract ownership. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.

Example input: `{"contract_address":"<contract_address>","wallet":"<wallet>"}`

### `alchemy_logs_get`

Get Logs · Read-only

Get event logs matching contract addresses, topics and a block range (eth_getLogs).
Returns logs with address, topics, data, block number and transaction hash.
Keep block ranges small; use Get Asset Transfers for token transfer history.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `block_hash` (`string`, optional): Only logs from this block. Not used with from_block or to_block. Example: 0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35.
- `contract_addresses` (`array`, optional): Only logs from these contract addresses. Example: ["0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48"].
- `from_block` (`string`, optional): First block, as hex or a tag. Defaults to latest. Example: 0x1312d00.
- `to_block` (`string`, optional): Last block, as hex or a tag. Defaults to latest. Example: latest.
- `topics` (`array`, optional): Topic filters by position; use null for any, or a list for OR. Topic 0 is the event signature hash. Example: ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"].

Example input: `{}`

### `alchemy_max_priority_fee_get`

Get Max Priority Fee · Read-only

Get a suggested EIP-1559 priority fee (tip) per gas (eth_maxPriorityFeePerGas).
Returns the fee in wei as hex.
Use Get Fee History for historical base fees.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `alchemy_network_version_get`

Get Network Version · Read-only

Get the network ID of the connection's network (net_version).
Returns the network ID as a decimal string.
Use Get Chain ID for the EIP-155 chain ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `alchemy_nft_attributes_summarize`

Summarize NFT Attributes · Read-only

Summarize how common each attribute value is across a collection.
Returns total supply and counts per trait type and value.
Use Compute Rarity for one NFT's attribute rarity.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.

Example input: `{"contract_address":"<contract_address>"}`

### `alchemy_nft_metadata_batch_get`

Get NFT Metadata Batch · Read-only

Get metadata for up to 100 NFTs in one call.
Returns each NFT's name, image, attributes and contract details.
Use Get NFT Metadata for a single NFT.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tokens` (`array`, required): NFTs to look up, up to 100, each with contractAddress, tokenId and optional tokenType (ERC721 or ERC1155). Example: [{"contractAddress": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D", "tokenId": "44", "tokenType": "ERC721"}].
- `refresh_cache` (`boolean`, optional): Defaults to false for faster response times. If true will refresh metadata for given token. If false will check the cache and use it or refresh if cache doesn't exist. Example: false.
- `token_uri_timeout_in_ms` (`number`, optional): Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.

Example input: `{"tokens":[{"contractAddress":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D","tokenId":"44","tokenType":"ERC721"}]}`

### `alchemy_nft_metadata_get`

Get NFT Metadata · Read-only

Get one NFT's metadata by contract address and token ID.
Returns its name, description, image, attributes, token URI, contract details and timestamps.
Use Get NFT Metadata Batch for up to 100 NFTs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `token_id` (`string`, required): Token ID, in decimal or hex. Example: 44.
- `refresh_cache` (`boolean`, optional): Defaults to false for faster response times. If true will refresh metadata for given token. If false will check the cache and use it or refresh if cache doesn't exist. Example: false.
- `token_type` (`string`, optional): String - 'ERC721' or 'ERC1155'; specifies type of token to query for. API requests will perform faster if this is specified. Example: ERC721.
- `token_uri_timeout_in_ms` (`integer`, optional): Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.

Example input: `{"contract_address":"<contract_address>","token_id":"<token_id>"}`

### `alchemy_nft_rarity_compute`

Compute Rarity · Read-only

Compute the rarity of each attribute of one NFT within its collection.
Returns each trait type and value with its prevalence.
Use Summarize NFT Attributes for collection-wide counts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `token_id` (`string`, required): Token ID, in decimal or hex. Example: 44.

Example input: `{"contract_address":"<contract_address>","token_id":"<token_id>"}`

### `alchemy_nft_sales_get`

Get NFT Sales · Read-only

List NFT sales on supported marketplaces, filterable by block range, contract, token, buyer, seller and marketplace.
Returns sales with marketplace, buyer, seller, prices, fees and transaction hash, plus pageKey.
Use Get Floor Price for current listing floors.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `buyer_address` (`string`, optional): String - The address of the NFT buyer to filter sales by. Defaults to returning sales involving any buyer. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `contract_address` (`string`, optional): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `from_block` (`string`, optional): String - The block number to start fetching NFT sales data from. Allowed values are decimal and hex integers, and "latest". Defaults to "0". Example: 0.
- `limit` (`integer`, optional): Integer - The maximum number of NFT sales to return. Maximum and default values are 1000. Example: 50.
- `marketplace` (`string`, optional): Enum - The name of the NFT marketplace to filter sales by. The endpoint currently supports "seaport", "wyvern", "looksrare", "x2y2", "blur", and "cryptopunks". Defaults to returning sales from all supported marketplaces. Example: seaport. One of: `seaport`, `looksrare`, `x2y2`, `wyvern`, `blur`, `cryptopunks`.
- `order` (`string`, optional): Enum - Whether to return the results ascending from startBlock or descending from startBlock. Defaults to descending (false). Example: desc. One of: `asc`, `desc`.
- `page_key` (`string`, optional): Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
- `seller_address` (`string`, optional): String - The address of the NFT seller to filter sales by. Defaults to returning sales involving any seller. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `taker` (`string`, optional): Enum - Filter by whether the buyer or seller was the taker in the NFT trade. Allowed filter values are "BUYER" and "SELLER". Defaults to returning both buyer and seller taker trades. Example: BUYER. One of: `BUYER`, `SELLER`.
- `to_block` (`string`, optional): String - The block number to start fetching NFT sales data from. Allowed values are decimal and hex integers, and "latest". Defaults to "latest". Example: latest.
- `token_id` (`string`, optional): Token ID, in decimal or hex. Example: 44.

Example input: `{}`

### `alchemy_nfts_for_collection_get`

Get NFTs for Collection · Read-only

List the NFTs in a collection, by contract address or OpenSea slug.
Returns nfts with token ID, name, image and metadata, plus pageKey.
Use Get NFTs for Contract when you have the contract address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection_slug` (`string`, optional): OpenSea collection slug. Example: boredapeyachtclub.
- `contract_address` (`string`, optional): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `limit` (`integer`, optional): Integer - Sets the total number of NFTs returned in the response. Defaults to 100. Example: 50.
- `start_token` (`string`, optional): String - A tokenID offset used for pagination. Can be a hex string, or a decimal. Users can specify the offset themselves to start from a custom offset, or to fetch multiple token ranges in parallel. Example: 100.
- `token_uri_timeout_in_ms` (`integer`, optional): Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
- `with_metadata` (`boolean`, optional): true returns NFT metadata; false makes the response smaller and faster. Example: true.

Example input: `{}`

### `alchemy_nfts_for_contract_get`

Get NFTs for Contract · Read-only

List the NFTs in one contract, paged by token ID.
Returns nfts with token ID, name, image and metadata, plus pageKey.
Use Get NFTs for Collection to look up by OpenSea slug.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `limit` (`integer`, optional): Integer - Sets the total number of NFTs returned in the response. Defaults to 100. Example: 50.
- `start_token` (`string`, optional): String - A tokenID offset used for pagination. Can be a hex string, or a decimal. Users can specify the offset themselves to start from a custom offset, or to fetch multiple token ranges in parallel. Example: 100.
- `token_uri_timeout_in_ms` (`integer`, optional): Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
- `with_metadata` (`boolean`, optional): true returns NFT metadata; false makes the response smaller and faster. Example: true.

Example input: `{"contract_address":"<contract_address>"}`

### `alchemy_nfts_for_owner_get`

Get NFTs for Owner · Read-only

List the NFTs a wallet owns on the connection's network, with optional contract and spam filters.
Returns ownedNfts with contract, token ID, name, image and metadata, plus totalCount and pageKey.
Use Get Contracts for Owner or Get Collections for Owner for a per-collection view.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `owner` (`string`, required): Wallet address of the NFT owner (an ENS name also works on Ethereum mainnet). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `contract_addresses` (`array`, optional): Only NFTs from these contract addresses (up to 45). Example: ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"].
- `exclude_filters` (`array`, optional): Exclude NFTs that match these filters: SPAM or AIRDROPS. Example: ["SPAM"].
- `include_filters` (`array`, optional): Only include NFTs that match these filters: SPAM or AIRDROPS. Example: ["AIRDROPS"].
- `order_by` (`string`, optional): Enum - ordering scheme to use for ordering NFTs in the response. If unspecified, NFTs will be ordered by contract address and token ID. - transferTime: NFTs will be ordered by the time they were transferred into the wallet, with newest NFTs first. NOTE: this ordering is only supported on Ethereum Mainnet and Polygon Mainnet. Example: transferTime. One of: `transferTime`.
- `page_key` (`string`, optional): Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
- `page_size` (`integer`, optional): Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
- `spam_confidence_level` (`string`, optional): Spam confidence level used with the SPAM filter: VERY_HIGH, HIGH, MEDIUM or LOW. Example: HIGH. One of: `VERY_HIGH`, `HIGH`, `MEDIUM`, `LOW`.
- `token_uri_timeout_in_ms` (`integer`, optional): Milliseconds to wait for the token URI when fetching metadata live. Example: 5000.
- `with_metadata` (`boolean`, optional): true returns NFT metadata; false makes the response smaller and faster. Example: true.

Example input: `{"owner":"<owner>"}`

### `alchemy_owners_for_contract_get`

Get Owners for Contract · Read-only

List every wallet holding an NFT from a contract, optionally with per-token balances.
Returns owner addresses (and token balances), plus pageKey for large collections.
Use Is Holder of Contract to check one wallet.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `page_key` (`string`, optional): Pagination key returned as pageKey by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
- `with_token_balances` (`boolean`, optional): Boolean - If set to `true` the query will include the token balances per token id for each owner. `false` by default. Example: false.

Example input: `{"contract_address":"<contract_address>"}`

### `alchemy_owners_for_nft_get`

Get Owners for NFT · Read-only

Get the wallet(s) that own a specific NFT.
Returns the owner addresses.
Use Get Owners for Contract for every holder of a collection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `token_id` (`string`, required): Token ID, in decimal or hex. Example: 44.

Example input: `{"contract_address":"<contract_address>","token_id":"<token_id>"}`

### `alchemy_proof_get`

Get Proof · Read-only

Get the Merkle proof of an account and some of its storage slots (eth_getProof).
Returns balance, nonce, code hash, storage hash and account and storage proofs.
Use Get Storage At to read a value without a proof.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `storage_keys` (`array`, required): Storage slots to prove, as hex. Example: ["0x0"].
- `block` (`string`, optional): Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.

Example input: `{"address":"<address>","storage_keys":["0x0"]}`

### `alchemy_spam_contract_check`

Is Spam Contract · Read-only

Check whether Alchemy marks a contract as spam.
Returns isSpamContract true or false.
Use List Spam Contracts for the full list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.

Example input: `{"contract_address":"<contract_address>"}`

### `alchemy_spam_contracts_list`

List Spam Contracts · Read-only

List the contracts Alchemy marks as spam on the connection's network.
Returns the spam contract addresses.
Use Is Spam Contract to check one contract.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `alchemy_storage_at_get`

Get Storage At · Read-only

Read the value of a contract storage slot at a block (eth_getStorageAt).
Returns the 32-byte value as hex.
Use Call Contract to read through a contract's functions instead.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `position` (`string`, required): Storage slot position, as hex. Example: 0x0.
- `block` (`string`, optional): Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.

Example input: `{"address":"<address>","position":"<position>"}`

### `alchemy_token_allowance_get`

Get Token Allowance · Read-only

Get how many tokens a spender may move on an owner's behalf (alchemy_getTokenAllowance).
Returns the allowance as a decimal string.
Use Get Token Metadata for the token's decimals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract` (`string`, required): ERC-20 token contract address. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.
- `owner` (`string`, required): Token owner address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `spender` (`string`, required): Spender address the allowance was given to. Example: 0xdef1c0ded9bec7f1a1670819833240f027b25eff.

Example input: `{"contract":"<contract>","owner":"<owner>","spender":"<spender>"}`

### `alchemy_token_balances_get`

Get Token Balances · Read-only

Get an address's ERC-20 token balances, for all tokens it has held or for given contracts (alchemy_getTokenBalances).
Returns tokenBalances with contract address and hex balance, plus pageKey.
Use Get Token Metadata for symbol and decimals. Use Get Balance for the native coin.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `contract_addresses` (`array`, optional): Only these token contracts (up to 100). Omit to get every ERC-20 token the address has held. Example: ["0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48"].
- `max_count` (`integer`, optional): Balances per page, up to 100 (all-tokens mode only). Example: 100.
- `page_key` (`string`, optional): Pagination key from the previous call (all-tokens mode only). Example: 0x00000000000000000000000000000000000000000000000000000000000001a3.

Example input: `{"address":"<address>"}`

### `alchemy_token_metadata_get`

Get Token Metadata · Read-only

Get an ERC-20 token's metadata (alchemy_getTokenMetadata).
Returns name, symbol, decimals and logo URL.
Use it to format balances from Get Token Balances.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): ERC-20 token contract address. Example: 0xA0b86991c6218b36c1d19d4a2e9eB0cE3606eB48.

Example input: `{"contract_address":"<contract_address>"}`

### `alchemy_token_prices_by_address_get`

Get Token Prices by Address · Read-only

Get current prices for up to 25 tokens by network and contract address.
Returns each token's prices, or an error.
Use Get Token Prices by Symbol for well-known symbols.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `addresses` (`array`, required): Tokens to price, up to 25 (at most 3 networks), each with network (for example eth-mainnet) and address (the token contract). Example: [{"network": "eth-mainnet", "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}].

Example input: `{"addresses":[{"network":"eth-mainnet","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}]}`

### `alchemy_token_prices_by_symbol_get`

Get Token Prices by Symbol · Read-only

Get current USD prices for up to 25 tokens by symbol.
Returns each symbol's prices with currency, value and last updated time, or an error.
Use Get Token Prices by Address for a specific contract on a network.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbols` (`array`, required): Token symbols to price, up to 25, for example ETH and BTC. Example: ["ETH", "BTC"].

Example input: `{"symbols":["ETH","BTC"]}`

### `alchemy_token_prices_historical_get`

Get Historical Token Prices · Read-only

Get a token's price history over a time range, by symbol or by network and address.
Returns price data points with value and timestamp (and market data if asked).
Use Get Token Prices by Symbol for the current price.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_time` (`string`, required): End of the range, ISO 8601. Example: 2026-10-31T00:00:00Z.
- `start_time` (`string`, required): Start of the range, ISO 8601 (or Unix seconds as text). Example: 2026-10-01T00:00:00Z.
- `address` (`string`, optional): Token contract address. Use with network. Example: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.
- `interval` (`string`, optional): Data point interval: 5m (up to 7 days), 1h (up to 30 days) or 1d (default, up to 1 year). Example: 1d. One of: `5m`, `1h`, `1d`.
- `network` (`string`, optional): Network of the token contract, for example eth-mainnet. Use with address. Example: eth-mainnet.
- `symbol` (`string`, optional): Token symbol, for example ETH. Give this, or network and address. Example: ETH.
- `with_market_data` (`boolean`, optional): Include market cap and volume. Example: false.

Example input: `{"end_time":"<end_time>","start_time":"<start_time>"}`

### `alchemy_transaction_count_get`

Get Transaction Count · Read-only

Get the number of transactions sent from an address, its nonce (eth_getTransactionCount).
Returns the count as hex.
Use block pending to get the next nonce to use.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Account or contract address (20 bytes, hex). Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
- `block` (`string`, optional): Block number in hex (for example 0x10d4f), or a tag: latest (default), safe, finalized, earliest or pending. Example: latest.

Example input: `{"address":"<address>"}`

### `alchemy_transaction_get`

Get Transaction · Read-only

Get a transaction by hash (eth_getTransactionByHash).
Returns from, to, value, gas, input data, nonce and block details, or null if unknown.
Use Get Transaction Receipt for its status and logs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tx_hash` (`string`, required): Transaction hash (32 bytes, hex). Example: 0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b.

Example input: `{"tx_hash":"<tx_hash>"}`

### `alchemy_transaction_receipt_get`

Get Transaction Receipt · Read-only

Get a mined transaction's receipt (eth_getTransactionReceipt).
Returns status, gas used, effective gas price, contract address and logs.
Use Get Transaction for the transaction's input fields.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tx_hash` (`string`, required): Transaction hash (32 bytes, hex). Example: 0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b.

Example input: `{"tx_hash":"<tx_hash>"}`

### `alchemy_transaction_receipts_get`

Get Transaction Receipts · Read-only

Get all transaction receipts in a block by number or hash (alchemy_getTransactionReceipts).
Returns the receipts with status, gas used and logs.
Use Get Block Receipts for the standard method.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `block_hash` (`string`, optional): Block hash. Give this or block_number. Example: 0xb3b20624f8f0f86eb50dd04688409e5cea4bd02d700bf6e79e9384d47d6a5a35.
- `block_number` (`string`, optional): Block number, as hex. Give this or block_hash. Example: 0xF1D1C6.

Example input: `{}`

### `alchemy_wallet_nft_contracts_get`

Get Wallet NFT Collections · Read-only

Get the NFT collections (contracts) held by up to 2 wallets across several networks.
Returns collections per wallet and network with metadata, plus pageKey.
Use Get Wallet NFTs for the individual tokens.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `addresses` (`array`, required): Wallets to query, up to 2 wallets with up to 15 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
- `page_key` (`string`, optional): Pagination key returned by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
- `page_size` (`integer`, optional): Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
- `with_metadata` (`boolean`, optional): true returns metadata; false makes the response smaller. Example: true.

Example input: `{"addresses":[{"network":"eth-mainnet","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}]}`

### `alchemy_wallet_nfts_get`

Get Wallet NFTs · Read-only

Get the NFTs held by up to 2 wallets across several networks.
Returns NFTs per wallet and network with metadata, plus pageKey.
Use Get NFTs for Owner for one wallet on the connection's network.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `addresses` (`array`, required): Wallets to query, up to 2 wallets with up to 15 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
- `page_key` (`string`, optional): Pagination key returned by the previous call. Omit for the first page. Example: 0x0000000000000000000000000000000000000000000000000000000000000065.
- `page_size` (`integer`, optional): Number of NFTs to be returned per page. Defaults to 100. Max is 100. Example: 50.
- `with_metadata` (`boolean`, optional): true returns metadata; false makes the response smaller. Example: true.

Example input: `{"addresses":[{"network":"eth-mainnet","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}]}`

### `alchemy_wallet_token_balances_get`

Get Wallet Token Balances · Read-only

Get native and ERC-20 token balances for up to 3 wallets across up to 20 networks each.
Returns token balances per wallet and network, plus pageKey.
Use Get Wallet Tokens to also get prices and metadata.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `addresses` (`array`, required): Wallets to query, up to 3 wallets with up to 20 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
- `include_native_tokens` (`boolean`, optional): Whether to include each chain's native token in the response (e.g. ETH on Ethereum). The native token will have a null contract address. Example: true.

Example input: `{"addresses":[{"network":"eth-mainnet","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}]}`

### `alchemy_wallet_tokens_get`

Get Wallet Tokens · Read-only

Get the native and ERC-20 tokens held by up to 2 wallets across several networks, with balances, prices and metadata.
Returns tokens per wallet and network with balance, price and metadata, plus pageKey.
Use Get Wallet Token Balances for balances only across more networks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `addresses` (`array`, required): Wallets to query, up to 2 wallets with up to 5 networks each, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
- `include_native_tokens` (`boolean`, optional): Whether to include each chain's native token in the response (e.g. ETH on Ethereum). The native token will have a null contract address. Example: true.
- `with_metadata` (`boolean`, optional): true returns metadata; false makes the response smaller. Example: true.
- `with_prices` (`boolean`, optional): Boolean - if set to `true`, returns token prices. Setting this to false will reduce payload size and may result in a faster API call. Defaults to `true`. Example: true.

Example input: `{"addresses":[{"network":"eth-mainnet","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}]}`

### `alchemy_wallet_transactions_get`

Get Wallet Transaction History · Read-only

Get the full transaction history (internal and external) of a wallet on up to 2 networks.
Returns transactions with hash, block, from, to, value, logs and timestamps, plus before and after cursors.
Use Get Asset Transfers for token transfer history on the connection's network.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `addresses` (`array`, required): Wallets to query, 1 wallet with up to 2 networks, each with address and a networks list (for example eth-mainnet, base-mainnet). Example: [{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "networks": ["eth-mainnet", "base-mainnet"]}].
- `after` (`string`, optional): The cursor that points to the end of the current set of results. Example: eyJibG9jayI6MTIzfQ.
- `before` (`string`, optional): The cursor that points to the previous set of results. Example: eyJibG9jayI6MTIzfQ.
- `limit` (`integer`, optional): Sets the maximum number of items per page (Max: 100). Example: 50.

Example input: `{"addresses":[{"network":"eth-mainnet","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}]}`

### `alchemy_contract_cache_invalidate`

Invalidate Contract Cache · Write

Mark every cached token of a contract as stale so the next queries fetch live data.
Returns the number of tokens invalidated.
Use Refresh NFT Metadata to refresh one token.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.

Example input: `{"contract_address":"<contract_address>"}`

### `alchemy_nft_metadata_refresh`

Refresh NFT Metadata · Write

Ask Alchemy to refresh the cached metadata of one NFT.
Returns the refresh status.
Use Invalidate Contract Cache to refresh a whole contract.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contract_address` (`string`, required): Contract address of the NFT collection (ERC-721 or ERC-1155). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.
- `token_id` (`string`, required): Token ID, in decimal or hex. Example: 44.

Example input: `{"contract_address":"<contract_address>","token_id":"<token_id>"}`

### `alchemy_raw_transaction_send`

Send Raw Transaction · Write

Broadcast a transaction you have already signed (eth_sendRawTransaction).
Returns the transaction hash. This moves funds on-chain and cannot be undone.
Use Get Transaction Receipt to follow it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `signed_transaction` (`string`, required): Signed, RLP-encoded transaction as hex. Sign it with your own wallet first. Example: 0xf86c808504a817c80082520894....

Example input: `{"signed_transaction":"<signed_transaction>"}`

### `alchemy_spam_report`

Report Spam · Write

Report an address to Alchemy as suspected spam.
Returns a confirmation.
Use Is Spam Contract to check the current classification.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): String - any valid blockchain address for NFT collections, contracts, mints, etc. Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.

Example input: `{"address":"<address>"}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
