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-prices-api.md

View on GitHub
---
id: references/data-prices-api.md
name: 'Prices API'
description: 'Query token prices for current and historical data using Alchemy''s Prices API.'
tags:
  - alchemy
  - data-apis
  - data
related:
  - recipes-get-prices-current-historical.md
updated: 2026-02-23
---
# Prices API

Query current and historical token prices. REST endpoints (GET and POST).

**Base URL**: `https://api.g.alchemy.com/prices/v1/$ALCHEMY_API_KEY`

---

## `GET /tokens/by-symbol`

Get current prices by token symbol.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbols` | string (query, repeated) | Yes | One `symbols` param per token (max 25). Example: `?symbols=ETH&symbols=BTC&symbols=USDC` |

### Request

```bash
curl -s "https://api.g.alchemy.com/prices/v1/$ALCHEMY_API_KEY/tokens/by-symbol?symbols=ETH&symbols=BTC"
```

### Response

```json
{
  "data": [
    {
      "symbol": "ETH",
      "prices": [
        { "currency": "usd", "value": "1970.69", "lastUpdatedAt": "2025-06-01T12:00:00Z" }
      ]
    },
    {
      "symbol": "BTC",
      "prices": [
        { "currency": "usd", "value": "67727.36", "lastUpdatedAt": "2025-06-01T12:00:00Z" }
      ]
    }
  ]
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `data` | array | List of token price objects |
| `data[].symbol` | string | Token symbol |
| `data[].prices` | array | Price entries (typically one per currency) |
| `data[].prices[].currency` | string | Currency code (e.g., `"usd"`) |
| `data[].prices[].value` | string | Price as decimal string |
| `data[].prices[].lastUpdatedAt` | string | ISO 8601 timestamp |
| `data[].error` | object | Error details if symbol not found (omitted on success) |

> **Note**: This endpoint does not return market cap, 24h volume, or
> percent change. To get market data, use `POST /tokens/historical`
> with `withMarketData: true`.

---

## `POST /tokens/by-address`

Get current prices by contract address. Must be POST with JSON body.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `addresses` | array (body) | Yes | Token address/network pairs (max 25 addresses, max 3 networks) |
| `addresses[].network` | string | Yes | Network slug (e.g., `"eth-mainnet"`) |
| `addresses[].address` | string | Yes | Token contract address |

### Request

```bash
curl -s -X POST "https://api.g.alchemy.com/prices/v1/$ALCHEMY_API_KEY/tokens/by-address" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      { "network": "eth-mainnet", "address": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" },
      { "network": "eth-mainnet", "address": "0xdac17f958d2ee523a2206206994597c13d831ec7" }
    ]
  }'
```

### Response

```json
{
  "data": [
    {
      "network": "eth-mainnet",
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "prices": [
        { "currency": "usd", "value": "0.9998", "lastUpdatedAt": "2025-06-01T12:00:00Z" }
      ]
    },
    {
      "network": "eth-mainnet",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "prices": [
        { "currency": "usd", "value": "1.0001", "lastUpdatedAt": "2025-06-01T12:00:00Z" }
      ]
    }
  ]
}
```

---

## `POST /tokens/historical`

Get historical token prices with configurable intervals. Must be POST with JSON body.

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Conditional | Token symbol (e.g., `"ETH"`). Use this OR `network`+`address`. |
| `network` | string | Conditional | Network slug. Use with `address` instead of `symbol`. |
| `address` | string | Conditional | Token contract address. Use with `network` instead of `symbol`. |
| `startTime` | string or number | Yes | Start time (ISO 8601 string or Unix timestamp in seconds) |
| `endTime` | string or number | Yes | End time (ISO 8601 string or Unix timestamp in seconds) |
| `interval` | string | No | `"5m"`, `"1h"`, or `"1d"` (default: `"1d"`) |
| `withMarketData` | boolean | No | Include market cap and volume (default: `false`) |

**Max ranges**: `5m` → 7 days, `1h` → 30 days, `1d` → 1 year.

### Request

```bash
curl -s -X POST "https://api.g.alchemy.com/prices/v1/$ALCHEMY_API_KEY/tokens/historical" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "ETH",
    "startTime": "2025-01-01T00:00:00Z",
    "endTime": "2025-01-07T00:00:00Z",
    "interval": "1h",
    "withMarketData": true
  }'
```

### Response

```json
{
  "symbol": "ETH",
  "currency": "usd",
  "data": [
    {
      "value": "3350.12",
      "timestamp": "2025-01-01T00:01:13Z",
      "marketCap": "274292310008.22",
      "totalVolume": "6715146404.61"
    },
    {
      "value": "3348.50",
      "timestamp": "2025-01-01T01:03:18Z",
      "marketCap": "274100000000.00",
      "totalVolume": "6700000000.00"
    }
  ]
}
```

### Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `symbol` | string | Token symbol |
| `currency` | string | Currency code (e.g., `"usd"`) |
| `data` | array | Chronologically sorted price points |
| `data[].value` | string | Price as decimal string |
| `data[].timestamp` | string | ISO 8601 timestamp |
| `data[].marketCap` | string | Market cap (only if `withMarketData: true`) |
| `data[].totalVolume` | string | 24h volume (only if `withMarketData: true`) |

---

## Notes

- Not all tokens are supported. Check the `error` field in the response for unsupported tokens.
- Historical data returns single price points per interval, not OHLCV candles.
- Symbol-based endpoints are network-agnostic. Address-based endpoints require specifying the network.

## Agentic Gateway

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

## Official Docs
- [Prices API Quickstart](https://www.alchemy.com/docs/reference/prices-api-quickstart)
- [Token Prices by Symbol](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol)
- [Token Prices by Address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address)
- [Historical Token Prices](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices)
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