import { AgentHub } from "rwagenthub-sdk";

const hub = new AgentHub({ privateKey: process.env.WALLET_PRIVATE_KEY });

// Execute any API — payment handled automatically
const result = await hub.call("stock_quote", { symbol: "NVDA" });
console.log(result.price); // 134.20

// Check price before calling (free, no payment)
const { price_usd } = await hub.estimate("flight_search");
console.log(price_usd); // 0.01

// List all available APIs with prices (free)
const { apis } = await hub.listApis();

// Get JSON Schema for any API (free)
const schema = await hub.schema("weather_forecast");

Constructor

new AgentHub({ privateKey, gateway? })

Option	Type	Required	Description
`privateKey`	`string`	yes	Private key of a Base Mainnet wallet with USDC (`0x...`)
`gateway`	`string`	no	Gateway base URL (defaults to the hosted instance)

Methods

`hub.call(api, inputs)` → `Promise<object>`

Calls an API and returns the data field directly. Payment is handled transparently via x402. Throws on payment failure or API error.

const weather = await hub.call("weather_forecast", { location: "Tokyo", days: 3 });
const flights = await hub.call("flight_search", { from: "JFK", to: "LAX", date: "2026-06-01" });
const prices  = await hub.call("crypto_price", { coins: "btc,eth,sol" });

`hub.estimate(api)` → `Promise<{ success, api, price_usd }>`

Returns the cost of an API call without executing it. Free — no payment required.

`hub.listApis()` → `Promise<{ apis }>`

Lists all 24 available APIs with their names and prices. Free.

`hub.schema(api?)` → `Promise<object>`

Returns the JSON Schema (inputs + outputs) for one API or all APIs. Free.

Available APIs

API	Description	Price
`flight_search`	One-way flight search	$0.01
`flight_status`	Real-time flight status	$0.01
`seat_map`	Seat map for a flight offer	$0.01
`airport_search`	Airport lookup by name/IATA	$0.01
`hotel_search`	Hotels by city and dates	$0.06
`activities_search`	Tours and experiences by GPS	$0.01
`web_search`	Google web/news search	$0.02
`web_search_ai`	AI-optimized semantic search	$0.02
`places_search`	Local businesses and POIs	$0.02
`image_search`	Google image search	$0.01
`shopping_search`	Google Shopping results	$0.02
`url_extract`	Fetch URL as clean Markdown	$0.02
`weather_forecast`	15-day forecast via Visual Crossing	$0.01
`crypto_price`	Real-time crypto prices	$0.01
`exchange_rate`	Forex rates for 160+ currencies	$0.01
`defi_market_snapshot`	DeFi TVL, DEX volume, top protocols	$0.02
`defi_yields`	Best yield farming pools	$0.02
`stock_quote`	Real-time stock quote	$0.01
`stock_profile`	Company profile and market cap	$0.01
`stock_search`	Symbol search by company name	$0.01
`market_news`	Financial news by symbol or category	$0.01
`earnings_calendar`	Upcoming earnings announcements	$0.01
`email_send`	Send transactional email via Resend	$0.01
`code_exec`	Execute code in isolated sandbox	$0.05