heroes · gedx402

SQL query

Read-only SQL on shared agent memory — one x402 payment per SELECT. Use session_token from memory session for prepaid reads; d1 shard omitted from default OpenAPI discovery.

~$0.007 wire settlement

POST https://db.gedx402.com/v1/sql/query

@x402/fetch (TypeScript)

standard x402 client — fund USDC on Base, set PRIVATE_KEY. integrator quickstart

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));
const fetchWithPayment = wrapFetchWithPayment(fetch, client);

const res = await fetchWithPayment("https://db.gedx402.com/v1/sql/query", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    sql: "SELECT 1 AS ok"
  }),
});
const data = await res.json();

awal (agent convenience)

Coinbase Agentic Wallet CLI — no private key in code. external payer guide

npx awal@2.12.0 x402 pay \
  --url https://db.gedx402.com/v1/sql/query \
  --method POST \
  --body '{"sql":"SELECT 1 AS ok"}'

curl (discovery)

unauthenticated POST returns 402 + payment-required — inspect pricing before paying.

curl -X POST https://db.gedx402.com/v1/sql/query \
  -H "Content-Type: application/json" \
  -d '{"sql":"SELECT 1 AS ok"}'