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

rules/overview.md

View on GitHub
# Gateway Overview

The Alchemy Agentic Gateway lets agents easily access Alchemy's developer platform, authenticating with SIWE and paying per-request with USDC via the x402 protocol.

## Base URL

```
https://x402.alchemy.com
```

The gateway exposes four API routes:

| Route | Example | Description |
|-------|---------|-------------|
| `/:chainNetwork/v2` | `/eth-mainnet/v2` | Node JSON-RPC + Token API + Transfers API |
| `/:chainNetwork/nft/v3/*` | `/eth-mainnet/nft/v3/getNFTsForOwner?owner=0x...` | NFT API v3 (REST) |
| `/data/v1/*` | `/data/v1/assets/tokens/by-address` | Portfolio API (not chain-specific) |
| `/prices/v1/*` | `/prices/v1/tokens/by-symbol?symbols=ETH` | Prices API (current + historical) |

See [reference](reference.md) for all endpoints, supported chains, and available methods.

## End-to-End Flow

1. **Set up a wallet** — Use an existing Ethereum wallet or generate a new private key.
2. **Fund the wallet** — Load USDC on a supported payment network (Base Mainnet or Base Sepolia for testnet).
3. **Create a SIWE token** — Sign a SIWE message with your private key. This proves wallet ownership.
4. **Send a request** — Call any gateway route with the `Authorization: SIWE <token>` header. For quick queries without an npm project, see the [curl-workflow](curl-workflow.md) for a lightweight curl-based alternative.
5. **Handle 402 Payment Required** — If the gateway returns 402, create an x402 payment from the response and retry with a `Payment-Signature` header.
6. **Receive the result** — After payment, the gateway proxies the request to Alchemy and returns the result. Subsequent requests with the same SIWE token do not require payment again.

## Required npm Packages

```bash
npm install viem siwe @x402/core @x402/evm @x402/fetch
```

| Package | Purpose |
|---------|---------|
| `viem` | Ethereum wallet creation, message signing, account derivation |
| `siwe` | SIWE (Sign-In With Ethereum) message construction |
| `@x402/core` | x402 client, HTTP client, payment payload encoding |
| `@x402/evm` | EVM-specific payment scheme registration (`exact` scheme) |
| `@x402/fetch` | `wrapFetchWithPayment` — auto-handles 402 → sign → retry |
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