How to use Forex Rates with Mastra
Integrate Forex Rates into your Mastra 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.
About Mastra
Mastra is a TypeScript-first framework for building AI agents and workflows. It provides type-safe tool definitions and composable agent pipelines.
Integration Guide
Install Mastra
npm install mastraGet your SettleGrid API key
Purchase credits for Forex Rates, then generate an API key from your Consumer Dashboard.
Register Forex Rates in your Mastra agent
import { Agent, createTool } from "mastra";
import { z } from "zod";
// Define the tool with Zod schema
const forex_ratesTool = createTool({
id: "forex_rates",
description: "ForexRates — call via SettleGrid",
inputSchema: z.object({
query: z.string().describe("Input query"),
}),
execute: async ({ context }) => {
const resp = await fetch(
"https://proxy.settlegrid.ai/v1/forex_rates",
{
method: "POST",
headers: {
"x-api-key": "sg_live_your_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({ query: context.query }),
}
);
if (!resp.ok) throw new Error(`ForexRates failed: ${resp.status}`);
return resp.json();
},
});
// Create an agent with the tool
const agent = new Agent({
name: "forex_rates-agent",
instructions: "Use ForexRates to accomplish the task.",
model: { provider: "OPEN_AI", name: "gpt-4o" },
tools: { forex_rates: forex_ratesTool },
});
const result = await agent.generate("Use ForexRates for this input");Run your agent
Execute your Mastra agent. SettleGrid automatically meters each call to Forex Rates and deducts from your credit balance. No rate limits beyond your purchased credits.
Pricing
No subscriptions or minimums. Credits never expire. See full pricing details.
Try Forex Rates
Purchase credits and start using Forex Rates in your Mastra agent today.
View Forex Rates →Other Frameworks
Use Forex Rates with other agent frameworks: