ToolVet
81trust / 100

Geo Forward

by TBS Geocoding API in Weather & location

x402 APIPassing, checked 5 h ago

Forward geocoding for AI agents: turn a place name or address into coordinates. Returns the best-match latitude, longitude, country and ISO country code, administrative regions (admin1/admin2), population, IANA timezone and GeoNames feature code. Query by q= or address=. Sourced from Open-Meteo geocoding — keyless, unified schema, stablecoin-payable.

GET https://x402.tbs-digital.com/geo/forward

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
61 ms typical, 61 ms slowest 5%
Last check
5 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://x402.tbs-digital.com/geo/forward?q=Paris"
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fx402.tbs-digital.com%2Fgeo%2Fforward
const res = await pay("https://x402.tbs-digital.com/geo/forward?q=Paris");
console.log(await res.json());

Example input

{
  "q": "Paris"
}

Example output

{
  "generated_at": "2026-08-11T12:00:00.000Z",
  "location": {
    "admin1": "Île-de-France",
    "admin2": "Paris",
    "country": "France",
    "country_code": "FR",
    "feature_code": "PPLC",
    "lat": 48.85341,
    "lon": 2.3488,
    "name": "Paris",
    "population": 2138551,
    "timezone": "Europe/Paris"
  },
  "payer": {
    "address": "0x0000000000000000000000000000000000000000",
    "network": "base"
  },
  "request_id": "0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55",
  "source": "open-meteo"
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
5 h agoPassed40261 ms$0.001