{
  "x402Version": 2,
  "id": 29149,
  "slug": "29149",
  "resource": "https://api.agentmercantile.com/v1/allowance-exposure",
  "description": "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.",
  "type": "http",
  "serviceName": "Agent Mercantile",
  "resourceType": "Blockchain Data",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xdb7b2b54f80479826222749a2ea73a8acc306e1e",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 60
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "additionalProperties": true,
        "properties": {
          "allowance_adjusted": {
            "type": [
              "string",
              "null"
            ]
          },
          "allowance_balance_exposure_adjusted": {
            "type": [
              "string",
              "null"
            ]
          },
          "allowance_balance_exposure_raw": {
            "type": [
              "string",
              "null"
            ]
          },
          "allowance_covers_current_balance": {
            "type": "boolean"
          },
          "allowance_raw": {
            "description": "uint256 as a decimal integer string",
            "type": [
              "string",
              "null"
            ]
          },
          "balance_adjusted": {
            "type": [
              "string",
              "null"
            ]
          },
          "balance_raw": {
            "type": [
              "string",
              "null"
            ]
          },
          "block_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "effectively_unlimited": {
            "type": "boolean"
          },
          "evidence": {
            "properties": {
              "block_number": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "same_block_reads": {
                "type": "boolean"
              },
              "token_code_present": {
                "type": [
                  "boolean",
                  "null"
                ]
              }
            },
            "type": "object"
          },
          "limitations": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "machine": {
            "enum": [
              "VM02"
            ],
            "type": "string"
          },
          "max_uint256_approval": {
            "type": "boolean"
          },
          "methodology_version": {
            "enum": [
              "allowance-exposure-0.1.0"
            ],
            "type": "string"
          },
          "network": {
            "enum": [
              "eip155:8453"
            ],
            "type": "string"
          },
          "owner": {
            "type": "string"
          },
          "spender": {
            "type": "string"
          },
          "status": {
            "enum": [
              "OK",
              "HOLD"
            ],
            "type": "string"
          },
          "token": {
            "type": "string"
          },
          "token_metadata": {
            "properties": {
              "decimals": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "symbol": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "type": "object"
          }
        },
        "required": [
          "status",
          "machine",
          "methodology_version",
          "network",
          "block_number",
          "owner",
          "token",
          "spender",
          "token_metadata",
          "allowance_raw",
          "allowance_adjusted",
          "balance_raw",
          "balance_adjusted",
          "allowance_balance_exposure_raw",
          "allowance_balance_exposure_adjusted",
          "allowance_covers_current_balance",
          "max_uint256_approval",
          "effectively_unlimited",
          "evidence",
          "limitations"
        ],
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "description": "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.",
        "input": {
          "body": {
            "owner": "0x0000000000000000000000000000000000000001",
            "spender": "0x0000000000000000000000000000000000000002",
            "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "example": {
            "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"
            }
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "body": {
                "additionalProperties": false,
                "properties": {
                  "owner": {
                    "description": "ERC-20 token owner address. 0x-prefixed 20-byte EVM address.",
                    "type": "string"
                  },
                  "spender": {
                    "description": "Spender address. 0x-prefixed 20-byte EVM address.",
                    "type": "string"
                  },
                  "token": {
                    "description": "ERC-20 token contract. 0x-prefixed 20-byte EVM address. Zero address is rejected.",
                    "type": "string"
                  }
                },
                "required": [
                  "owner",
                  "token",
                  "spender"
                ],
                "type": "object"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              },
              "method": {
                "enum": [
                  "POST"
                ],
                "type": "string"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "additionalProperties": true,
                "properties": {
                  "allowance_adjusted": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "allowance_balance_exposure_adjusted": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "allowance_balance_exposure_raw": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "allowance_covers_current_balance": {
                    "type": "boolean"
                  },
                  "allowance_raw": {
                    "description": "uint256 as a decimal integer string",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "balance_adjusted": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "balance_raw": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "block_number": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "effectively_unlimited": {
                    "type": "boolean"
                  },
                  "evidence": {
                    "properties": {
                      "block_number": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "same_block_reads": {
                        "type": "boolean"
                      },
                      "token_code_present": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      }
                    },
                    "type": "object"
                  },
                  "limitations": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "machine": {
                    "enum": [
                      "VM02"
                    ],
                    "type": "string"
                  },
                  "max_uint256_approval": {
                    "type": "boolean"
                  },
                  "methodology_version": {
                    "enum": [
                      "allowance-exposure-0.1.0"
                    ],
                    "type": "string"
                  },
                  "network": {
                    "enum": [
                      "eip155:8453"
                    ],
                    "type": "string"
                  },
                  "owner": {
                    "type": "string"
                  },
                  "spender": {
                    "type": "string"
                  },
                  "status": {
                    "enum": [
                      "OK",
                      "HOLD"
                    ],
                    "type": "string"
                  },
                  "token": {
                    "type": "string"
                  },
                  "token_metadata": {
                    "properties": {
                      "decimals": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "symbol": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "type": "object"
                  }
                },
                "required": [
                  "status",
                  "machine",
                  "methodology_version",
                  "network",
                  "block_number",
                  "owner",
                  "token",
                  "spender",
                  "token_metadata",
                  "allowance_raw",
                  "allowance_adjusted",
                  "balance_raw",
                  "balance_adjusted",
                  "allowance_balance_exposure_raw",
                  "allowance_balance_exposure_adjusted",
                  "allowance_covers_current_balance",
                  "max_uint256_approval",
                  "effectively_unlimited",
                  "evidence",
                  "limitations"
                ],
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "erc20-allowance",
    "spender-allowance",
    "token-approval",
    "allowance-exposure",
    "unlimited-approval",
    "bazaar"
  ],
  "sourceHost": "api.agentmercantile.com",
  "lastUpdated": "2026-10-04T02:53:38.341Z",
  "quality": {
    "calls30d": 3,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-10-04T02:53:38.067Z"
  },
  "metadata": {
    "serviceName": "Agent Mercantile",
    "extensions": {
      "bazaar": {
        "info": {
          "description": "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.",
          "input": {
            "body": {
              "owner": "0x0000000000000000000000000000000000000001",
              "spender": "0x0000000000000000000000000000000000000002",
              "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "example": {
              "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"
              }
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "body": {
                  "additionalProperties": false,
                  "properties": {
                    "owner": {
                      "description": "ERC-20 token owner address. 0x-prefixed 20-byte EVM address.",
                      "type": "string"
                    },
                    "spender": {
                      "description": "Spender address. 0x-prefixed 20-byte EVM address.",
                      "type": "string"
                    },
                    "token": {
                      "description": "ERC-20 token contract. 0x-prefixed 20-byte EVM address. Zero address is rejected.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "owner",
                    "token",
                    "spender"
                  ],
                  "type": "object"
                },
                "bodyType": {
                  "enum": [
                    "json",
                    "form-data",
                    "text"
                  ],
                  "type": "string"
                },
                "method": {
                  "enum": [
                    "POST"
                  ],
                  "type": "string"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method",
                "bodyType",
                "body"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "additionalProperties": true,
                  "properties": {
                    "allowance_adjusted": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "allowance_balance_exposure_adjusted": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "allowance_balance_exposure_raw": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "allowance_covers_current_balance": {
                      "type": "boolean"
                    },
                    "allowance_raw": {
                      "description": "uint256 as a decimal integer string",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "balance_adjusted": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "balance_raw": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "block_number": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "effectively_unlimited": {
                      "type": "boolean"
                    },
                    "evidence": {
                      "properties": {
                        "block_number": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "same_block_reads": {
                          "type": "boolean"
                        },
                        "token_code_present": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        }
                      },
                      "type": "object"
                    },
                    "limitations": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "machine": {
                      "enum": [
                        "VM02"
                      ],
                      "type": "string"
                    },
                    "max_uint256_approval": {
                      "type": "boolean"
                    },
                    "methodology_version": {
                      "enum": [
                        "allowance-exposure-0.1.0"
                      ],
                      "type": "string"
                    },
                    "network": {
                      "enum": [
                        "eip155:8453"
                      ],
                      "type": "string"
                    },
                    "owner": {
                      "type": "string"
                    },
                    "spender": {
                      "type": "string"
                    },
                    "status": {
                      "enum": [
                        "OK",
                        "HOLD"
                      ],
                      "type": "string"
                    },
                    "token": {
                      "type": "string"
                    },
                    "token_metadata": {
                      "properties": {
                        "decimals": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "symbol": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "type": "object"
                    }
                  },
                  "required": [
                    "status",
                    "machine",
                    "methodology_version",
                    "network",
                    "block_number",
                    "owner",
                    "token",
                    "spender",
                    "token_metadata",
                    "allowance_raw",
                    "allowance_adjusted",
                    "balance_raw",
                    "balance_adjusted",
                    "allowance_balance_exposure_raw",
                    "allowance_balance_exposure_adjusted",
                    "allowance_covers_current_balance",
                    "max_uint256_approval",
                    "effectively_unlimited",
                    "evidence",
                    "limitations"
                  ],
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.agentmercantile.com",
    "manifest_name": "api.agentmercantile.com",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {
      "allowance_adjusted": "string",
      "allowance_balance_exposure_adjusted": "string",
      "allowance_balance_exposure_raw": "string",
      "allowance_covers_current_balance": true,
      "allowance_raw": "string",
      "balance_adjusted": "string",
      "balance_raw": "string",
      "block_number": "string",
      "effectively_unlimited": true,
      "evidence": {
        "block_number": "string",
        "same_block_reads": true,
        "token_code_present": true
      },
      "limitations": [
        "string"
      ],
      "machine": "VM02",
      "max_uint256_approval": true,
      "methodology_version": "allowance-exposure-0.1.0",
      "network": "eip155:8453",
      "owner": "string",
      "spender": "string",
      "status": "OK",
      "token": "string",
      "token_metadata": {
        "decimals": 0,
        "symbol": "string"
      }
    },
    "type": "string"
  }
}