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/node-json-rpc.md

View on GitHub
---
id: references/node-json-rpc.md
name: 'JSON-RPC (EVM)'
description: 'Use Alchemy''s EVM JSON-RPC endpoints for standard blockchain reads and writes (e.g., `eth_call`, `eth_getLogs`, `eth_sendRawTransaction`). This is the baseline for any EVM integration.'
tags:
  - alchemy
  - node-apis
  - evm
  - rpc
  - json-rpc
related:
  - node-enhanced-apis.md
  - data-transfers-api.md
  - operational-rate-limits-and-compute-units.md
updated: 2026-02-23
---
# JSON-RPC (EVM)

Standard Ethereum JSON-RPC methods via Alchemy's node infrastructure. All requests are `POST` with JSON-RPC 2.0 bodies.

**Base URL (HTTPS)**: `https://<network>.g.alchemy.com/v2/$ALCHEMY_API_KEY`
**Base URL (WSS)**: `wss://<network>.g.alchemy.com/v2/$ALCHEMY_API_KEY`

**Networks**: `eth-mainnet`, `eth-sepolia`, `polygon-mainnet`, `polygon-amoy`, `arb-mainnet`, `arb-sepolia`, `opt-mainnet`, `opt-sepolia`, `base-mainnet`, `base-sepolia`, `bnb-mainnet`.

---

## `eth_blockNumber`

Returns the current block number.

### Parameters

None.

### 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":"eth_blockNumber","params":[]}'
```

### Response

```json
{ "jsonrpc": "2.0", "id": 1, "result": "0x1312D00" }
```

The result is the block number as a hex string.

---

## `eth_getBalance`

Returns the native token balance (ETH, MATIC, etc.) for an address.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address` | string | Yes | Wallet address (hex, 20 bytes) |
| `blockTag` | string | No | `"latest"`, `"earliest"`, `"pending"`, `"safe"`, `"finalized"`, or hex block number. Default: `"latest"` |

### 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": "eth_getBalance",
    "params": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "latest"]
  }'
```

### Response

```json
{ "jsonrpc": "2.0", "id": 1, "result": "0x112210f47de98000" }
```

Result is the balance in wei (hex). Divide by 10^18 for ETH.

---

## `eth_call`

Executes a read-only call against a contract (no state changes, no gas cost).

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transaction.to` | string | Yes | Contract address |
| `transaction.from` | string | No | Caller address |
| `transaction.data` | string | No | ABI-encoded function call (hex) |
| `transaction.value` | string | No | ETH value (hex, usually `"0x0"`) |
| `transaction.gas` | string | No | Gas limit (hex) |
| `blockTag` | string | No | Block tag or hex number. Default: `"latest"` |

### 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": "eth_call",
    "params": [
      {
        "to": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "data": "0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
      },
      "latest"
    ]
  }'
```

### Response

```json
{ "jsonrpc": "2.0", "id": 1, "result": "0x0000000000000000000000000000000000000000000000000000000005f5e100" }
```

Result is the ABI-encoded return data (hex). Decode using the function's return types.

---

## `eth_getLogs`

Returns event logs matching a filter.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter.fromBlock` | string | No | Start block (hex or `"latest"`). Default: `"latest"` |
| `filter.toBlock` | string | No | End block (hex or `"latest"`). Default: `"latest"` |
| `filter.address` | string or string[] | No | Contract address(es) to filter |
| `filter.topics` | array | No | Up to 4 topic filters. `null` means any. |
| `filter.blockHash` | string | No | Filter to a specific block (cannot use with fromBlock/toBlock) |

### 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": "eth_getLogs",
    "params": [{
      "fromBlock": "0x1312D00",
      "toBlock": "0x1312D05",
      "address": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }]
  }'
```

### Response

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",
        "0x000000000000000000000000ef4396d9ff8107086d215a1c9f8866c54795d7c7"
      ],
      "data": "0x00000000000000000000000000000000000000000000000000000000000f4240",
      "blockNumber": "0x1312D01",
      "transactionHash": "0x3847245c...",
      "transactionIndex": "0x5",
      "blockHash": "0x...",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `address` | string | Emitting contract address |
| `topics` | string[] | Indexed event parameters |
| `data` | string | Non-indexed event data (hex) |
| `blockNumber` | string | Block number (hex) |
| `transactionHash` | string | Transaction hash |
| `transactionIndex` | string | Transaction index in block (hex) |
| `blockHash` | string | Block hash |
| `logIndex` | string | Log index in block (hex) |
| `removed` | boolean | `true` if removed due to chain reorg |

---

## `eth_getTransactionReceipt`

Returns the receipt of a mined transaction.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transactionHash` | string | Yes | Transaction hash (32 bytes, hex) |

### 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": "eth_getTransactionReceipt",
    "params": ["0x3847245c01829b043431067fb2bfa95f7b5bdc7e..."]
  }'
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `transactionHash` | string | Transaction hash |
| `transactionIndex` | string | Index in block (hex) |
| `blockHash` | string | Block hash |
| `blockNumber` | string | Block number (hex) |
| `from` | string | Sender address |
| `to` | string | Recipient address (null for contract creation) |
| `cumulativeGasUsed` | string | Total gas used in block up to this tx (hex) |
| `gasUsed` | string | Gas used by this tx (hex) |
| `effectiveGasPrice` | string | Actual gas price paid (hex) |
| `contractAddress` | string | Created contract address (null if not a deployment) |
| `logs` | array | Event logs (same schema as `eth_getLogs`) |
| `logsBloom` | string | Bloom filter for logs (hex) |
| `status` | string | `"0x1"` (success) or `"0x0"` (failure) |
| `type` | string | Transaction type (hex): `"0x0"` (legacy), `"0x1"` (EIP-2930), `"0x2"` (EIP-1559) |

---

## `eth_getBlockByNumber`

Returns block data by block number.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `blockTag` | string | Yes | Block number (hex) or `"latest"`, `"earliest"`, `"pending"`, `"safe"`, `"finalized"` |
| `fullTransactions` | boolean | Yes | `true` for full tx objects, `false` for tx hashes only |

### 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": "eth_getBlockByNumber",
    "params": ["latest", false]
  }'
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `number` | string | Block number (hex) |
| `hash` | string | Block hash |
| `parentHash` | string | Parent block hash |
| `timestamp` | string | Block timestamp (hex, Unix seconds) |
| `gasLimit` | string | Gas limit (hex) |
| `gasUsed` | string | Gas used (hex) |
| `baseFeePerGas` | string | Base fee (hex, EIP-1559) |
| `miner` | string | Block producer address |
| `transactions` | array | Transaction hashes (or full objects if `fullTransactions: true`) |

---

## `eth_sendRawTransaction`

Submits a signed transaction to the network.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `signedTransaction` | string | Yes | Signed transaction data (hex) |

### 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": "eth_sendRawTransaction",
    "params": ["0xf86c...signed_tx_hex..."]
  }'
```

### Response

```json
{ "jsonrpc": "2.0", "id": 1, "result": "0x3847245c01829b...transaction_hash..." }
```

Result is the transaction hash. Use `eth_getTransactionReceipt` to check if it was mined.

---

## Other Common Methods

| Method | Description |
|--------|-------------|
| `eth_gasPrice` | Current gas price (hex, wei) |
| `eth_estimateGas` | Estimate gas for a transaction |
| `eth_getTransactionByHash` | Get transaction by hash |
| `eth_getCode` | Get contract bytecode |
| `eth_getStorageAt` | Read contract storage slot |
| `eth_getTransactionCount` | Get nonce for an address |
| `eth_feeHistory` | Fee history for EIP-1559 gas estimation |
| `eth_maxPriorityFeePerGas` | Suggested priority fee |
| `net_version` | Network ID |
| `web3_clientVersion` | Node client version |

---

## Notes

- All quantities are hex-encoded strings (e.g., `"0x10"` = 16).
- Block tags: `"latest"` (most recent), `"finalized"` (finalized by consensus), `"safe"` (safe head), `"earliest"` (genesis), `"pending"` (pending state).
- `eth_getLogs` over large block ranges can be expensive. Chunk requests and use narrow ranges.
- Handle HTTP `429` (rate limit) with exponential backoff.
- Handle JSON-RPC errors in the response body (`error.code`, `error.message`).

## 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
- [Chain APIs Overview](https://www.alchemy.com/docs/reference/chain-apis-overview)
- [Ethereum API Endpoints](https://www.alchemy.com/docs/chains/ethereum/ethereum-api-endpoints)
- [How to Read Data with JSON-RPC](https://www.alchemy.com/docs/how-to-read-data-with-json-rpc)
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