A

Agent Mercantile · Allowance Exposure

by Agent Mercantile

POSTBase

$0.01

per call · USD Coin on Base

Inspect one Base ERC-20 owner/token/spender allowance with same-block balance and token metadata plus factual exposure flags. No wallet access, signing, or transaction execution. Call when you need a same-block Base allowance-versus-balance snapshot for one owner/token/spender triple.

Endpoint

POST https://api.agentmercantile.com/v1/allowance-exposure

5

Calls / 30d

3

Unique payers / 30d

Sep 6

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.agentmercantile.com/v1/allowance-exposure", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "owner": "0x0000000000000000000000000000000000000001",
    "spender": "0x0000000000000000000000000000000000000002",
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  }),
});
const data = await res.json();
cURL
curl -X POST \
  "https://api.agentmercantile.com/v1/allowance-exposure" \
  -H "Content-Type: application/json" \
  -d '{"owner":"0x0000000000000000000000000000000000000001","spender":"0x0000000000000000000000000000000000000002","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}' \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "allowance_adjusted": "1",
  "allowance_balance_exposure_adjusted": "0.5",
  "allowance_balance_exposure_raw": "500000",
  "allowance_covers_current_balance": true,
  "allowance_raw": "1000000",
  "balance_adjusted": "0.5",
  "balance_raw": "500000",
  "block_number": "12345678",
  "effectively_unlimited": false,
  "evidence": {
    "block_number": "12345678",
    "same_block_reads": true,
    "token_code_present": true
  },
  "limitations": [
    "Base Mainnet only (eip155:8453)."
  ],
  "machine": "VM02",
  "max_uint256_approval": false,
  "methodology_version": "allowance-exposure-0.1.0",
  "network": "eip155:8453",
  "owner": "0x0000000000000000000000000000000000000001",
  "spender": "0x0000000000000000000000000000000000000002",
  "status": "OK",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "token_metadata": {
    "decimals": 6,
    "symbol": "USDC"
  }
}

Payment details

Pay to0xdb7b2b54f80479826222749a2ea73a8acc306e1e
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase
Schemesexact

Is this your API?

Pin it to the top of Onchain Data and the homepage with a featured placement.

Get featured →

More from Agent Mercantile & similar services