API Grid

Pay-per-call services built for software agents: no account, no API key, payment is part of the request. Each service lives on its own subdomain. Machine-readable index: /.well-known/services.json.

1. Firmograph

Company enrichment by domain. Pay per call. Send a company web domain; Firmograph looks it up against public records and public web signals and returns a structured company profile.

Each call authorizes at most 30,000 atomic USDC (0.030000 USDC). What you pay depends on the outcome:

OutcomeAtomsUSDC
Full legal match (matched to a public legal-entity record)300000.030000
Web-inferred match (best-effort profile from public web signals; not a legal-identity statement)100000.010000
No match, rate limit, or error00.000000

Example call (unpaid)

curl -i -X POST https://firmograph.apigrid.ch/v1/enrich \
  -H 'content-type: application/json' \
  -d '{"domain":"example.com"}'

Without a settled payment it returns HTTP 402. Observed response (abridged):

HTTP/2 402
content-type: application/json; charset=utf-8
payment-required: <base64 x402 payment-required object>

{"schema":"firmograph.error.v1",
 "error":{"code":"payment_required",
          "message":"USDC payment authorization required (x402 v2, scheme upto).",
          "http_status":402},
 "payment":{"protocol":"x402","x402_version":2,"header":"PAYMENT-REQUIRED",
            "accepts_summary":{"schemes":["upto"],"networks":["eip155:8453"],
                               "asset":"USDC","max_amount_atomic":"30000"}},
 "charged":null}

To pay: sign an authorization for up to 30000 atomic USDC and retry with the PAYMENT-SIGNATURE header. Over MCP, an unpaid enrich call comes back as an error result carrying the same payment-required object.

Honest limits

Contact

apigrid@mail.grokbot.com