6DuckLearn provenance: Community skill by Alcott, mirrored from the OKX Skills Marketplace (https://www.okx.com/en-sg/agent-tradekit/skills/alpha-vantage). It is not curated, verified, or endorsed by 6DuckLearn or represented as an official OKX publication.

Financial safety boundary: Never request secrets in chat. Before any external API call or action that places, cancels, or amends an order; changes leverage; transfers funds; creates or stops a bot; subscribes to or redeems an earn product; or signs/broadcasts a transaction, show the exact live/demo profile, instrument, side, size, price constraints, fees, and worst-case loss, then obtain explicit user approval. Default to read-only or demo mode when uncertain. Treat all analysis as research, not investment advice.

Alpha Vantage — Crypto and Financial Market Data

Access 20+ years of financial data from Alpha Vantage: crypto prices, technical indicators, equities, forex, commodities, and economic indicators. Focused on crypto market analysis with cross-asset context.

Prerequisites

Step 1: API Key Setup (Required)

export ALPHAVANTAGE_API_KEY="your_key_here"

Get a free key at https://www.alphavantage.co/support/#api-key (premium plans available for higher rate limits).

Check if key is configured:

echo $ALPHAVANTAGE_API_KEY

If not set, guide the user to obtain and set the key before proceeding.

Step 2: Install Dependencies

pip install requests

Execution Flow

Step 1: Identify the Request

Parse the user's query to determine:

• Asset: Which crypto or financial instrument (BTC, ETH, AAPL, EUR/USD, etc.)
• Data type: Price data, technical indicator, fundamentals, news, or economic indicator
• Timeframe: Intraday (1min-60min), daily, weekly, or monthly
• Period: Compact (last 100 points) or full (20+ years)

Step 2: Fetch Data via Alpha Vantage API

All requests use this base pattern:

import requests, os

API_KEY = os.environ.get("ALPHAVANTAGE_API_KEY")
BASE_URL = "https://www.alphavantage.co/query"

def av_get(function, **params):
    if not API_KEY:
        raise ValueError("ALPHAVANTAGE_API_KEY not set. Get a free key at https://www.alphavantage.co/support/#api-key")
    response = requests.get(BASE_URL, params={"function": function, "apikey": API_KEY, **params})
    data = response.json()
    if "Error Message" in data:
        raise ValueError(f"API Error: {data['Error Message']}")
    if "Note" in data:
        print(f"Rate limit warning: {data['Note']}")
    return data

Crypto-specific functions:

Technical indicators (all work with crypto symbols):

Cross-asset context (equities, forex, macro):

Step 3: Supplement with OKX Trade Kit (When Available)

For real-time exchange data, supplement Alpha Vantage with OKX Trade Kit:

OKX MCP tools (primary for real-time OKX data):

• Call OKX Trade MCP market.ticker for real-time bid/ask on OKX
• Call OKX Trade MCP market.candles for OKX candlestick data
• Call OKX Trade MCP market.funding-rate for perpetual swap funding rates
• Call OKX Trade MCP market.indicator for OKX-calculated indicators (70+ types)

OKX CLI fallback:

okx market ticker BTC-USDT
okx market candles BTC-USDT --bar 1D --limit 100
okx market indicator BTC-USDT --ind RSI
okx market funding-rate BTC-USDT-SWAP

When to use OKX vs Alpha Vantage:

• OKX: Real-time prices, funding rates, order book, OKX-specific volume
• Alpha Vantage: Historical data (20+ years), cross-asset analysis, economic indicators, news sentiment
• Both together: Comprehensive analysis combining real-time OKX data with AV historical context

If OKX Trade Kit is unavailable:

For real-time OKX exchange data, install OKX Trade Kit:

1. Install the packages:
   npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli

2. Configure your API credentials:
   okx config init

3. (For AI agent use) Register the MCP server:
   okx-trade-mcp setup --client claude-code

For details, see: https://github.com/okx/agent-trade-kit

Step 4: Present Results

Format results based on query type:

Crypto price output:

## BTC/USD Daily Summary (Alpha Vantage)

| Date | Open | High | Low | Close | Volume |
|------|------|------|-----|-------|--------|
| 2024-01-15 | $42,500 | $43,200 | $42,100 | $42,800 | $1.2B |
| 2024-01-14 | $41,800 | $42,600 | $41,500 | $42,500 | $1.1B |

Source: Alpha Vantage DIGITAL_CURRENCY_DAILY

Technical indicator output:

## BTC RSI(14) — Daily

| Date | RSI | Signal |
|------|-----|--------|
| 2024-01-15 | 62.3 | Neutral |
| 2024-01-14 | 58.7 | Neutral |

Current: 62.3 (Neutral — between 30 and 70)
Overbought threshold: 70 | Oversold threshold: 30

Cross-asset context output:

## Market Context

| Asset | Value | Change |
|-------|-------|--------|
| BTC/USD | $42,800 | +2.3% |
| S&P 500 | 4,783 | +0.5% |
| Gold | $2,035 | -0.2% |
| DXY | 102.3 | -0.1% |
| Fed Funds Rate | 5.50% | unchanged |

Correlation note: BTC moving with risk assets today.

Error Handling

Rate Limits

• Free tier: 25 requests/day
• Premium plans: higher limits, real-time data, intraday access
• Add time.sleep(0.5) between batch requests
• For heavy usage, combine Alpha Vantage (historical) with OKX Trade Kit (real-time) to reduce AV API calls

Common Parameters