Claude AI for Trading: Using Tool Use with Financial APIs

tools = [
    {
        "name": "get_technical_indicators",
        "description": "Fetch real-time technical indicator values for a forex or crypto trading pair from the TickAtlas API.",
        "input_schema": {
            "type": "object",
            "properties": {
                "symbol": {
                    "type": "string",
                    "description": "The trading pair symbol, e.g. EURUSD, XAUUSD, BTCUSD"
                },
                "timeframe": {
                    "type": "string",
                    "enum": ["M5", "M15", "H1", "H4", "D1"],
                    "description": "The candle timeframe"
                },
                "indicators": {
                    "type": "string",
                    "description": "Comma-separated indicator names: RSI_14, MACD_main, MACD_signal, MACD_hist, BB_upper, BB_middle, BB_lower, ADX, ATR_14, EMA_10, EMA_20, Stochastic_K, Stochastic_D, Ichimoku_tenkan, Ichimoku_kijun"
                }
            },
            "required": ["symbol", "timeframe", "indicators"]
        }
    },
    {
        "name": "get_price_quote",
        "description": "Get the current bid/ask price for a trading pair.",
        "input_schema": {
            "type": "object",
            "properties": {
                "symbol": {
                    "type": "string",
                    "description": "The trading pair symbol"
                }
            },
            "required": ["symbol"]
        }
    },
    {
        "name": "get_ohlc_history",
        "description": "Fetch historical OHLC candle data for backtesting or trend analysis.",
        "input_schema": {
            "type": "object",
            "properties": {
                "symbol": {"type": "string"},
                "timeframe": {"type": "string"},
                "limit": {"type": "integer", "description": "Number of candles (max 1000)"}
            },
            "required": ["symbol", "timeframe"]
        }
    }
]

import json
import requests

CLAW_API_KEY = "your_tickatlas_api_key"
CLAW_BASE = "https://tickatlas.com/v1"
CLAW_HEADERS = {"X-API-Key": CLAW_API_KEY}

def handle_tool(name: str, inputs: dict) -> str:
    """Route tool calls to the TickAtlas API."""
    if name == "get_technical_indicators":
        # The endpoint returns all 42; trim to the keys Claude asked for.
        resp = requests.get(f"{CLAW_BASE}/indicators", params={
            "symbol": inputs["symbol"],
            "timeframe": inputs["timeframe"],
        }, headers=CLAW_HEADERS)
        all_ind = resp.json()["data"]["indicators"]
        wanted = [k.strip() for k in inputs["indicators"].split(",")]
        return json.dumps({k: all_ind[k] for k in wanted if k in all_ind})

    elif name == "get_price_quote":
        resp = requests.get(f"{CLAW_BASE}/quote", params={
            "symbol": inputs["symbol"]
        }, headers=CLAW_HEADERS)
        return resp.text

    elif name == "get_ohlc_history":
        resp = requests.get(f"{CLAW_BASE}/ohlc", params={
            "symbol": inputs["symbol"],
            "timeframe": inputs["timeframe"],
            "limit": inputs["bars"]
        }, headers=CLAW_HEADERS)
        return resp.text

    return '{"error": "Unknown tool"}'

import anthropic
import json

client = anthropic.Anthropic()

SYSTEM = """You are a professional trading analyst with access to
real-time market data. When analyzing markets:
1. Always fetch live data before making claims about current conditions
2. Cite specific indicator values in your analysis
3. Consider multiple timeframes when relevant
4. Note any conflicting signals honestly
5. Never recommend specific trade entries — provide analysis only"""

def analyze(question: str) -> str:
    messages = [{"role": "user", "content": question}]

    while True:
        response = client.messages.create(
            model="claude-sonnet-4-20250514",
            max_tokens=4096,
            system=SYSTEM,
            tools=tools,
            messages=messages
        )

        # Check if Claude wants to use a tool
        if response.stop_reason == "tool_use":
            # Add Claude's response (with tool_use blocks)
            messages.append({"role": "assistant", "content": response.content})

            # Process each tool call
            tool_results = []
            for block in response.content:
                if block.type == "tool_use":
                    result = handle_tool(block.name, block.input)
                    tool_results.append({
                        "type": "tool_result",
                        "tool_use_id": block.id,
                        "content": result
                    })

            messages.append({"role": "user", "content": tool_results})
        else:
            # Claude is done — extract text response
            return "".join(
                b.text for b in response.content if b.type == "text"
            )

# Example usage
analysis = analyze("Analyze XAUUSD — is it a good time to buy gold?")
print(analysis)

# Claude will automatically make multiple tool calls
analysis = analyze("""
    Compare RSI and MACD across EURUSD, GBPUSD, USDJPY, and XAUUSD
    on both H1 and H4 timeframes. Which pair has the strongest
    momentum right now?
""")
# Claude fetches 8 sets of indicators (4 pairs x 2 timeframes)
# and synthesizes the results