Alpha Vantage — Dados do Mercado Financeiro

Acesse mais de 20 anos de dados financeiros globais: ações, opções, câmbio, criptomoedas, commodities, indicadores econômicos e mais de 50 indicadores técnicos.

Configuração da Chave de API (Obrigatório)

1. Obtenha uma chave gratuita em https://www.alphavantage.co/support/#api-key (planos premium disponíveis para limites de taxa mais altos)
2. Defina como variável de ambiente:

read -rsp "Alpha Vantage API key: " ALPHAVANTAGE_API_KEY
echo
export ALPHAVANTAGE_API_KEY

Instalação

uv pip install requests pandas

URL Base e Padrão de Requisição

Todas as requisições vão para:

https://www.alphavantage.co/query?function=FUNCTION_NAME&apikey=YOUR_KEY&...params

import requests
import os

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

def av_get(function, **params):
    response = requests.get(BASE_URL, params={"function": function, "apikey": API_KEY, **params})
    return response.json()

Exemplos de Início Rápido

# Stock quote (latest price)
quote = av_get("GLOBAL_QUOTE", symbol="AAPL")
price = quote["Global Quote"]["05. price"]

# Daily OHLCV
daily = av_get("TIME_SERIES_DAILY", symbol="AAPL", outputsize="compact")
ts = daily["Time Series (Daily)"]

# Company fundamentals
overview = av_get("OVERVIEW", symbol="AAPL")
print(overview["MarketCapitalization"], overview["PERatio"])

# Income statement
income = av_get("INCOME_STATEMENT", symbol="AAPL")
annual = income["annualReports"][0]  # Most recent annual

# Crypto price
crypto = av_get("DIGITAL_CURRENCY_DAILY", symbol="BTC", market="USD")

# Economic indicator
gdp = av_get("REAL_GDP", interval="annual")

# Technical indicator
rsi = av_get("RSI", symbol="AAPL", interval="daily", time_period=14, series_type="close")

Categorias de API

Parâmetros Comuns

Limites de Taxa

• Plano gratuito: 25 requisições/dia (a partir de 2026)
• Planos premium: limites mais altos, dados em tempo real, acesso intraday
• HTTP 429 = limite de taxa excedido
• Adicione atrasos entre as requisições ao processar múltiplos símbolos

import time
# Add delay to avoid rate limits
time.sleep(0.5)  # 0.5s between requests on free tier

Tratamento de Erros

data = av_get("GLOBAL_QUOTE", symbol="AAPL")

# Check for API errors
if "Error Message" in data:
    raise ValueError(f"API Error: {data['Error Message']}")
if "Note" in data:
    print(f"Rate limit warning: {data['Note']}")
if "Information" in data:
    print(f"API info: {data['Information']}")

Quando Usar

Use esta habilidade ao lidar com tarefas relacionadas ao seu domínio principal ou funcionalidade, conforme descrito acima.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.