How to use Forex Rates with smolagents

Integrate Forex Rates into your smolagents agent with SettleGrid's per-call billing. No subscriptions, no minimums — pay only for what you use.

About Forex Rates

Forex Exchange Rates. Real-time and historical foreign exchange rates via the free Frankfurter API. No API key needed.

Finance & Paymentsv1.0.0by Lex Whiting

About smolagents

smolagents is Hugging Face's lightweight framework for building AI agents with minimal boilerplate. It emphasizes simplicity and tool composition.

Python

Integration Guide

1

Install smolagents

Terminal
pip install smolagents
2

Get your SettleGrid API key

Purchase credits for Forex Rates, then generate an API key from your Consumer Dashboard.

3

Register Forex Rates in your smolagents agent

Python
from smolagents import Tool, CodeAgent, HfApiModel
import requests

class ForexRatesTool(Tool):
    name = "forex_rates"
    description = "ForexRates — call via SettleGrid"
    inputs = {"query": {"type": "string", "description": "Input query"}}
    output_type = "string"

    def forward(self, query: str) -> str:
        resp = requests.post(
            "https://proxy.settlegrid.ai/v1/forex_rates",
            headers={
                "x-api-key": "sg_live_your_key_here",
                "Content-Type": "application/json",
            },
            json={"query": query},
        )
        resp.raise_for_status()
        return str(resp.json())

# Create agent with the tool
model = HfApiModel()
agent = CodeAgent(tools=[ForexRatesTool()], model=model)
result = agent.run("Use ForexRates to process this input")
4

Run your agent

Execute your smolagents agent. SettleGrid automatically meters each call to Forex Rates and deducts from your credit balance. No rate limits beyond your purchased credits.

Pricing

Cost per call5¢

No subscriptions or minimums. Credits never expire. See full pricing details.

Try Forex Rates

Purchase credits and start using Forex Rates in your smolagents agent today.

View Forex Rates →

SettleGrid Help

AI-powered support

How can I help?

Ask me anything about SettleGrid