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, BBANDS_20, ADX_14, ATR_14, EMA_9, EMA_21, STOCH_14_3_3, ICHIMOKU"
                }
            },
            "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"},
                "bars": {"type": "integer", "description": "Number of candles (max 500)"}
            },
            "required": ["symbol", "timeframe", "bars"]
        }
    }
]

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":
        resp = requests.get(f"{CLAW_BASE}/indicators", params={
            "symbol": inputs["symbol"],
            "timeframe": inputs["timeframe"],
            "indicators": inputs["indicators"]
        }, headers=CLAW_HEADERS)
        return resp.text

    elif name == "get_price_quote":
        resp = requests.get(f"{CLAW_BASE}/quotes", 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"],
            "bars": 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)