# Liquid Agent ERC-7677 Paymaster Data Provider

> Liquid Agent ERC-7677 Paymaster Data Provider is a paid API for AI agents from api.liquidagent.ai, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns ERC-7677-compliant paymaster data (sponsor gas) for a user operation, enabling gasless transactions on behalf of Liquid Agent dollar-account holders.

## Facts

- Endpoint: POST https://api.liquidagent.ai/v1/gas
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/liquid-agent-erc-7677-paymaster-data-provider-bdb172ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t72faAXyzWJeqA9kRsvcE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability liquid-agent-erc-7677-paymaster-data-provider-bdb172ad -d '<json body>'
```

Example prompt: I need paymaster data to sponsor the gas for this user operation — use Liquid Agent's paymaster with entry point 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 on chain 8453, and include the x402 payment authorization in the context.

## When to prefer this

Choose this endpoint when building ERC-4337 account abstraction flows that need ERC-7677-compliant gas sponsorship, specifically when your users hold a Liquid Agent dollar-account balance and you want to cover gas costs via an x402 micro-payment rather than managing your own paymaster infrastructure. Prefer this over generic paymaster services when you need tight integration with Liquid Agent's financial layer (yield, stock purchases, money transfers) and want a single balance to cover both app operations and gas fees.

## Known failure modes

- Invalid or missing x402 payment object in context — returns 400 with payment required error
- Expired or insufficient x402 payment — paymaster rejects authorization
- Unsupported chainId — returns 400 or empty paymasterData
- Malformed userOperation structure — returns 422 validation error
- Entry point address mismatch — paymaster refuses to sign
- paymasterData returned with a validUntil already in the past if clock skew is extreme
- Network timeout on paymaster RPC — agent must retry

## How this service works

A dollar account that puts your money on autopilot: earn yield, send money in seconds, and buy stocks from $1, all from one balance, with none of the crypto.

## Output

A JSON object containing: the paymaster contract address (e.g. 0x9676897C…), a hex-encoded paymasterData blob to attach to the userOperation, a validUntil Unix timestamp indicating when the sponsorship expires, paymasterVerificationGasLimit and paymasterPostOpGasLimit as hex values. This data must be inserted into the userOperation before sending to a bundler.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "method",
      "params"
     ],
     "properties": {
      "method": {
       "const": "pm_getPaymasterData"
      },
      "params": {
       "type": "array",
       "description": "[userOperation, entryPoint, chainId, context] per ERC-7677; put the x402 payment object in context.x402"
      }
     }
    },
    "type": {
     "const": "http"
    },
    "method": {
     "const": "POST"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "paymaster": "0x9676897C3BF08977Cdbe78213F84e72A29b844eC",
     "validUntil": 1790000000,
     "paymasterData": "0x…",
     "paymasterPostOpGasLimit": "0x0",
     "paymasterVerificationGasLimit": "0xea60"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/liquid-agent-erc-7677-paymaster-data-provider-bdb172ad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.liquidagent.ai](https://www.zero.xyz/host/api.liquidagent.ai/llms.txt)
