Skip to content

LeoYeAI/agent-master-skills / skills/alchemy-official

alchemy-official

Verified

FileKindSize
AGENTIC-GATEWAY.mdmarkdown4.3 KB
SKILL.mdskill md24.0 KB
SOURCE.mdmarkdown188 B
_meta.jsonconfig466 B
references/data-nft-api.mdmarkdown15.8 KB
references/data-overview.mdmarkdown2.0 KB
references/data-portfolio-apis.mdmarkdown15.9 KB
references/data-prices-api.mdmarkdown6.3 KB
references/data-simulation-api.mdmarkdown10.2 KB
references/data-token-api.mdmarkdown5.4 KB
references/data-transfers-api.mdmarkdown5.1 KB
references/ecosystem-anchor.mdmarkdown632 B
references/ecosystem-ethers.mdmarkdown772 B
references/ecosystem-foundry.mdmarkdown654 B
references/ecosystem-hardhat.mdmarkdown795 B
references/ecosystem-metaplex.mdmarkdown652 B
references/ecosystem-overview.mdmarkdown2.3 KB
references/ecosystem-rainbowkit.mdmarkdown604 B
references/ecosystem-solana-web3js.mdmarkdown766 B
references/ecosystem-spl-token.mdmarkdown737 B
references/ecosystem-viem.mdmarkdown827 B
references/ecosystem-wagmi.mdmarkdown829 B
references/ecosystem-web3js.mdmarkdown689 B
references/node-debug-api.mdmarkdown5.0 KB
references/node-enhanced-apis.mdmarkdown2.7 KB
references/node-json-rpc.mdmarkdown10.4 KB
references/node-overview.mdmarkdown2.1 KB
references/node-trace-api.mdmarkdown5.7 KB
references/node-utility-api.mdmarkdown3.1 KB
references/node-websocket-subscriptions.mdmarkdown4.1 KB
references/operational-alerts.mdmarkdown765 B
references/operational-allowlists.mdmarkdown819 B
references/operational-auth-and-keys.mdmarkdown1.1 KB
references/operational-best-practices.mdmarkdown1.0 KB
references/operational-dashboard-tools.mdmarkdown700 B
references/operational-jwt-and-header-auth.mdmarkdown1.1 KB
references/operational-overview.mdmarkdown2.0 KB
references/operational-pricing-and-plans.mdmarkdown916 B
references/operational-rate-limits-and-compute-units.mdmarkdown1.1 KB
references/operational-request-logs.mdmarkdown680 B
references/operational-roles-and-sso.mdmarkdown686 B
references/operational-sandbox.mdmarkdown686 B
references/operational-supported-networks.mdmarkdown2.3 KB
references/recipes-get-nft-metadata.mdmarkdown1.2 KB
references/recipes-get-nft-ownership.mdmarkdown1.2 KB
references/recipes-get-portfolio.mdmarkdown1.5 KB
references/recipes-get-prices-current-historical.mdmarkdown1.1 KB
references/recipes-get-token-balances.mdmarkdown1.4 KB
references/recipes-get-token-metadata.mdmarkdown1.3 KB
references/recipes-get-transfers-history.mdmarkdown1.0 KB
references/recipes-overview.mdmarkdown1.4 KB
references/recipes-simulate-transaction.mdmarkdown1.1 KB
references/recipes-subscribe-pending-txs.mdmarkdown1.7 KB
references/recipes-webhook-address-activity.mdmarkdown1.4 KB
references/rollups-details.mdmarkdown1.1 KB
references/rollups-overview.mdmarkdown793 B
references/solana-das-api.mdmarkdown9.0 KB
references/solana-grpc-best-practices.mdmarkdown896 B
references/solana-grpc-details.mdmarkdown1.0 KB
references/solana-grpc-examples.mdmarkdown958 B
references/solana-grpc-overview.mdmarkdown1.5 KB
references/solana-grpc-subscribe-accounts.mdmarkdown733 B
references/solana-grpc-subscribe-blocks.mdmarkdown739 B
references/solana-grpc-subscribe-request.mdmarkdown969 B
references/solana-grpc-subscribe-slots.mdmarkdown642 B
references/solana-grpc-subscribe-transactions.mdmarkdown890 B
references/solana-overview.mdmarkdown1.3 KB
references/solana-rpc.mdmarkdown7.2 KB
references/solana-wallets.mdmarkdown921 B
references/wallets-account-kit.mdmarkdown1.2 KB
references/wallets-bundler.mdmarkdown832 B
references/wallets-details.mdmarkdown1.1 KB
references/wallets-gas-manager.mdmarkdown799 B
references/wallets-overview.mdmarkdown1.6 KB
references/wallets-smart-wallets.mdmarkdown1.1 KB
references/wallets-solana-notes.mdmarkdown692 B
references/wallets-supported-chains.mdmarkdown737 B
references/wallets-wallet-apis.mdmarkdown1.0 KB
references/webhooks-address-activity.mdmarkdown1.5 KB
references/webhooks-custom-webhooks.mdmarkdown1.2 KB
references/webhooks-details.mdmarkdown2.5 KB
references/webhooks-nft-activity.mdmarkdown1.4 KB
references/webhooks-overview.mdmarkdown1.5 KB
references/webhooks-verify-signatures.mdmarkdown1.5 KB
references/webhooks-webhook-payloads.mdmarkdown1.1 KB
references/webhooks-webhook-types.mdmarkdown1.0 KB
rules/authentication.mdmarkdown4.5 KB
rules/curl-workflow.mdmarkdown8.5 KB
rules/making-requests.mdmarkdown5.6 KB
rules/overview.mdmarkdown2.2 KB
rules/payment.mdmarkdown3.4 KB
rules/reference.mdmarkdown5.0 KB
rules/wallet-bootstrap.mdmarkdown2.4 KB

references/data-transfers-api.md

View on GitHub
---
id: references/data-transfers-api.md
name: 'Transfers API'
description: 'Query historical transfers across ERC-20/721/1155 and native transfers without manual log scanning.'
tags:
  - alchemy
  - data-apis
  - data
related:
  - node-enhanced-apis.md
  - recipes-get-transfers-history.md
updated: 2026-02-23
---
# Transfers API

Query historical transfers across ERC-20, ERC-721, ERC-1155, and native transfers without scanning the chain. JSON-RPC POST request.

**Base URL**: `https://<network>.g.alchemy.com/v2/$ALCHEMY_API_KEY`

**Supported chains**: Ethereum, Base, Polygon, Arbitrum, Optimism (and testnets). `internal` category only available on Ethereum Mainnet and Polygon Mainnet.

---

## `alchemy_getAssetTransfers`

### Parameters

Accepts a single object with:

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `fromBlock` | string | No | `"0x0"` | Start block (hex or `"latest"`) |
| `toBlock` | string | No | `"latest"` | End block (hex, `"latest"`, or `"indexed"`) |
| `fromAddress` | string | No | — | Filter by sender address |
| `toAddress` | string | No | — | Filter by recipient address |
| `category` | string[] | Yes | — | Transfer types: `"external"`, `"internal"`, `"erc20"`, `"erc721"`, `"erc1155"`, `"specialnft"` |
| `contractAddresses` | string[] | No | — | Filter by token contract addresses |
| `excludeZeroValue` | boolean | No | `true` | Exclude zero-value transfers |
| `order` | string | No | `"asc"` | `"asc"` or `"desc"` by block number |
| `withMetadata` | boolean | No | `false` | Include block timestamp in response |
| `maxCount` | string | No | `"0x3e8"` | Max results per page (hex, max 1000) |
| `pageKey` | string | No | — | Pagination cursor (10-minute TTL) |

### Request

```bash
curl -s -X POST https://eth-mainnet.g.alchemy.com/v2/$ALCHEMY_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "alchemy_getAssetTransfers",
    "params": [{
      "fromBlock": "0x0",
      "toBlock": "latest",
      "toAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "category": ["external", "erc20"],
      "withMetadata": true,
      "maxCount": "0x5",
      "order": "desc"
    }]
  }'
```

### Response

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "transfers": [
      {
        "blockNum": "0x1234abc",
        "uniqueId": "0x...:log:0",
        "hash": "0x3847245c01829b043431067fb2bfa95f7b5bdc7e...",
        "from": "0xef4396d9ff8107086d215a1c9f8866c54795d7c7",
        "to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "value": 0.5,
        "asset": "ETH",
        "category": "external",
        "erc721TokenId": null,
        "erc1155Metadata": null,
        "tokenId": null,
        "rawContract": {
          "value": "0x6f05b59d3b20000",
          "address": null,
          "decimal": "0x12"
        },
        "metadata": {
          "blockTimestamp": "2024-06-15T10:30:00.000Z"
        }
      }
    ],
    "pageKey": "a1b2c3d4-e5f6-..."
  }
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `transfers` | array | List of transfer objects |
| `transfers[].blockNum` | string | Block number (hex) |
| `transfers[].uniqueId` | string | Unique transfer identifier |
| `transfers[].hash` | string | Transaction hash |
| `transfers[].from` | string | Sender address |
| `transfers[].to` | string | Recipient address |
| `transfers[].value` | number | Transferred amount (human-readable, may be null for NFTs) |
| `transfers[].asset` | string | Asset symbol (e.g., `"ETH"`, `"USDC"`) |
| `transfers[].category` | string | Transfer type (`"external"`, `"erc20"`, etc.) |
| `transfers[].erc721TokenId` | string | ERC-721 token ID (null if not applicable) |
| `transfers[].erc1155Metadata` | array | ERC-1155 metadata (null if not applicable) |
| `transfers[].tokenId` | string | Generic token ID field |
| `transfers[].rawContract.value` | string | Raw transfer value (hex) |
| `transfers[].rawContract.address` | string | Token contract address (null for native) |
| `transfers[].rawContract.decimal` | string | Token decimals (hex) |
| `transfers[].metadata.blockTimestamp` | string | Block timestamp (ISO 8601, only if `withMetadata: true`) |
| `pageKey` | string | Cursor for next page (absent if no more results) |

---

## Notes

- `fromAddress` and `toAddress` are optional but at least one filter (address, contract, or block range) is recommended to avoid large result sets.
- `pageKey` has a 10-minute TTL. Fetch subsequent pages promptly.
- Use narrow block ranges for polling patterns to reduce compute unit usage.
- The `internal` category tracks internal EVM calls and is only available on Ethereum Mainnet and Polygon Mainnet.

## Agentic Gateway

This API is also available via `https://x402.alchemy.com/{chainNetwork}/v2` without an API key.
See the `agentic-gateway` skill for SIWE authentication and x402 payment setup.

## Official Docs
- [Transfers API Quickstart](https://www.alchemy.com/docs/reference/transfers-api-quickstart)
- [alchemy_getAssetTransfers](https://www.alchemy.com/docs/reference/alchemy-getassettransfers)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall