PUBLIC TESTNET DEVELOPER API

Test Geomacro intelligence and create your own API credentials.

Create a tester profile, verify one EVM wallet with a non-transaction signature, then create an API Key + API Secret. There is no upfront Testnet USDC activation payment. Each API request quotes its own Testnet USDC amount at 0.5 Testnet USDC per credit.

Profile + wallet

Create a tester profile and verify one EVM wallet to activate Testnet developer access.

500-credit usage cap

500 credits is the 30-day Testnet usage limit, not a prepaid balance. One credit costs 0.5 Testnet USDC when consumed.

Create API credentials

After wallet verification, create an API Key + API Secret for a product, AI agent, automation or demo. The secret is shown once and only its hash is stored.

DEVELOPER API

The Testnet API surface is visible before you create credentials.

Use the manifest for machine discovery, inspect your metered account with paired credentials, then send intelligence requests to the canonical Geomacro Testnet endpoint.

GETManifest
https://geomacro.live/api/testnet/manifest

Capabilities, pricing and machine-readable discovery.

GETAccount
https://geomacro.live/api/testnet/account

Active entitlement, credit cap and account status.

POSTIntelligence
https://geomacro.live/api/testnet/intelligence

Metered geopolitical and macro intelligence requests.

Developer authentication
Authorization: GeomacroTest <API_KEY>.<API_SECRET>

Create the key pair below after verifying your wallet. Never put the API Secret in public source code or screenshots.

intelligence_querygri_readstructural_country_digeststructural_corridor_digeststructural_country_profilestructural_corridor_profilesigned_risk_objectrisk_gate_bundle
HOW A TESTNET API CALL WORKS
01Call the API
Authenticate with your API Key + API Secret.
02Receive HTTP 402
Geomacro returns the exact call price from its credit cost.
03Pay and retry
Pay only that Testnet USDC amount and retry the same request_id with proof.
Arc TestnetBase SepoliaPolygon AmoyTestnet only · non-revenue
CREATE TESTER PROFILE

Start developer access

Profile name and one verified wallet are the only identity steps for the current Testnet program.

Never enter a seed phrase or private key. Wallet verification is a message signature only and does not authorize funds.