Call any Apiosk APIin under 2 minutes.

// pay-per-call.ts
// Run with: npx tsx pay-per-call.ts

import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
import { wrapFetchWithPayment } from "x402-fetch";

const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);

const walletClient = createWalletClient({
  account,
  chain: base,
  transport: http(),
});

const fetchWithPayment = wrapFetchWithPayment(fetch, walletClient);

async function main(): Promise<void> {
  const response = await fetchWithPayment(
    "https://gateway.apiosk.com/v1/fx/convert?from=EUR&to=USD&amount=100",
  );

  const data = await response.json();
  console.log(data);
}

main().catch(console.error);

// apiosk-client.ts

import axios from "axios";
import { privateKeyToAccount } from "viem/accounts";
import { withPaymentInterceptor } from "x402-axios";

const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);

export const apiosk = withPaymentInterceptor(
  axios.create({ baseURL: "https://gateway.apiosk.com" }),
  account,
);

// Usage anywhere in your app:
// const { data } = await apiosk.get("/v1/email/verify", { params: { email } });

# pay_per_call.py
# pip install x402-httpx eth-account

import asyncio
import os

import httpx
from eth_account import Account
from x402_httpx import x402HTTPXClient

account = Account.from_key(os.environ["WALLET_PRIVATE_KEY"])


async def main() -> None:
    async with x402HTTPXClient(account=account) as client:
        response = await client.get(
            "https://gateway.apiosk.com/v1/fx/convert",
            params={"from": "EUR", "to": "USD", "amount": 100},
        )
        print(response.json())


asyncio.run(main())

// tools/convert-currency.ts

import { tool } from "ai";
import { z } from "zod";
import { apiosk } from "../apiosk-client"; // the x402-axios client from example 2

export const convertCurrency = tool({
  description:
    "Convert an amount between two currencies using live FX rates. " +
    "Costs a fraction of a cent per call, paid automatically in USDC.",
  parameters: z.object({
    from: z.string().describe("ISO currency code to convert from, e.g. EUR"),
    to: z.string().describe("ISO currency code to convert to, e.g. USD"),
    amount: z.number().positive(),
  }),
  execute: async ({ from, to, amount }) => {
    const { data } = await apiosk.get("/v1/fx/convert", {
      params: { from, to, amount },
    });
    return data;
  },
});

// agent.ts

import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";
import { convertCurrency } from "./tools/convert-currency";

const result = await generateText({
  model: anthropic("claude-sonnet-4-6"),
  tools: { convertCurrency },
  prompt: "What is 250 EUR in USD right now?",
});

console.log(result.text);

# tools/convert_currency.py

import os

import httpx
from eth_account import Account
from langchain_core.tools import tool
from x402_httpx import x402Client

account = Account.from_key(os.environ["WALLET_PRIVATE_KEY"])
client = x402Client(account=account)


@tool
def convert_currency(from_code: str, to_code: str, amount: float) -> dict:
    """Convert an amount between two currencies using live FX rates.

    Paid per call in USDC via x402. No API key required.
    """
    response = client.get(
        "https://gateway.apiosk.com/v1/fx/convert",
        params={"from": from_code, "to": to_code, "amount": amount},
    )
    response.raise_for_status()
    return response.json()

{
  "mcpServers": {
    "apiosk": {
      "url": "https://gateway.apiosk.com/mcp",
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

claude mcp add apiosk https://gateway.apiosk.com/mcp