{ "openapi": "3.1.0", "info": { "title": "automaton-value-api", "version": "0.9.0", "description": "x402-metered compute API. Per-route pricing on Base (0.001–0.05 USDC/call; see /pricing). Free trial: 3 calls/day/IP.", "contact": { "name": "Automaton Sovereign", "email": "baiano.marcelo.eduardo@gmail.com", "url": "https://api.automatonsvrn.xyz" } }, "servers": [ { "url": "https://api.automatonsvrn.xyz" } ], "components": { "securitySchemes": { "x402Payment": { "type": "apiKey", "name": "X-PAYMENT-AUTH", "in": "header", "description": "x402 EIP-712 payment authorization on Base (EIP-155:8453). Signs USDC TransferWithAuthorization." } } }, "paths": { "/health": { "get": { "summary": "Liveness", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/pricing": { "get": { "summary": "Pricing/terms", "responses": { "200": { "description": "Terms", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v1/hash": { "get": { "summary": "SHA-256 of input", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "input", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "digest", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v1/echo": { "get": { "summary": "Echo", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "msg", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "echo", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v1/uuid": { "get": { "summary": "UUIDv4", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "uuid", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v1/random": { "get": { "summary": "Random int", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "min", "schema": { "type": "integer" } }, { "in": "query", "name": "max", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "value", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v2/oracle/base": { "get": { "summary": "Signed DeFi Oracle & Base L2 gas meter", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "oracle data", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v2/merkle/prove": { "post": { "summary": "Generate on-demand Merkle proof", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "merkle proof", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v2/merkle/verify": { "post": { "summary": "Verify Merkle inclusion proof (free)", "responses": { "200": { "description": "proof verification", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v2/sentiment": { "get": { "summary": "Token & Contract sentiment / risk analysis", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "asset", "schema": { "type": "string" } } ], "responses": { "200": { "description": "sentiment analysis", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v2/security/scan": { "get": { "summary": "Base Token Safety & Honeypot Analyzer", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "address", "schema": { "type": "string" } } ], "responses": { "200": { "description": "token security scan", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } }, "post": { "summary": "Base Token Safety & Honeypot Analyzer", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "token security scan", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v2/simulate": { "get": { "summary": "Simulate a Base Mainnet transaction (revert prediction + gas)", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "to", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "data", "schema": { "type": "string" } }, { "in": "query", "name": "value", "schema": { "type": "string" } }, { "in": "query", "name": "from", "schema": { "type": "string" } } ], "responses": { "200": { "description": "simulation result", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } }, "post": { "summary": "Simulate a Base Mainnet transaction (JSON body {to,data,value,from})", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "simulation result", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v2/attest": { "get": { "summary": "Read or create signed attestation for input", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "data", "schema": { "type": "string" } } ], "responses": { "200": { "description": "entry", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 50000 USDC base units (0.05 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "50000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "50000" } }, "post": { "summary": "Create signed attestation", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "entry", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 50000 USDC base units (0.05 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "50000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "50000" } } }, "/v2/batch": { "post": { "summary": "Batch Merkle attestation: ONE signed root committing up to 1000 items", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "string" }, "maxItems": 1000 } }, "required": [ "items" ] } } } }, "responses": { "200": { "description": "merkle root", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 50000 USDC base units (0.05 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "50000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "50000" } } }, "/v2/sentinel/latest": { "get": { "summary": "Newest Base pools with the bytecode risk score of each token", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "limit", "schema": { "type": "integer" } }, { "in": "query", "name": "maxRisk", "schema": { "type": "integer" } }, { "in": "query", "name": "minRisk", "schema": { "type": "integer" } }, { "in": "query", "name": "dex", "schema": { "type": "string" } }, { "in": "query", "name": "since", "schema": { "type": "string" } } ], "responses": { "200": { "description": "pools", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 1000 USDC base units (0.001 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "1000" } } }, "/v2/sentinel/stream": { "get": { "summary": "Server-Sent Events feed of new Base pools, held open for 15 minutes per payment", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." }, { "in": "query", "name": "maxRisk", "schema": { "type": "integer" } }, { "in": "query", "name": "minRisk", "schema": { "type": "integer" } }, { "in": "query", "name": "dex", "schema": { "type": "string" } } ], "responses": { "200": { "description": "text/event-stream", "content": { "text/event-stream": { "schema": { "type": "string" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 10000 USDC base units (0.01 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" } } }, "/v2/token/approval-risk": { "post": { "summary": "Every live ERC-20 approval owner->spender, with drainable amount and verdict", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "owner": { "type": "string" }, "spenders": { "type": "array", "items": { "type": "string" } } }, "required": [ "token", "owner" ] } } } }, "responses": { "200": { "description": "approvals", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 10000 USDC base units (0.01 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" } } }, "/v2/token/simulate": { "post": { "summary": "Buy/sell simulation through the Uniswap V2 WETH pool: tax, slippage, honeypot verdict (no transaction sent)", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "side": { "type": "string", "enum": [ "buy", "sell" ] }, "amount": { "type": "string" }, "wallet": { "type": "string" } }, "required": [ "token", "side", "amount", "wallet" ] } } } }, "responses": { "200": { "description": "simulation", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 10000 USDC base units (0.01 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" } } }, "/v2/token/liquidity-risk": { "post": { "summary": "Pool depth, USD to move price, concentration and LP-lock evidence, one block snapshot", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "pair": { "type": "string" } }, "required": [ "token" ] } } } }, "responses": { "200": { "description": "liquidity", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 10000 USDC base units (0.01 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "10000" } } }, "/v2/firewall/simulate-tx": { "post": { "summary": "Pre-Flight AI Firewall: simulation, anti-honeypot and MEV safe slippage", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "firewall verdict", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 20000 USDC base units (0.02 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "20000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "20000" } } }, "/v2/security/preflight": { "post": { "summary": "Pre-Flight AI Firewall (alias): simulation, anti-honeypot and MEV safe slippage", "parameters": [ { "in": "header", "name": "X-PAYMENT-AUTH", "required": false, "schema": { "type": "string" }, "description": "Base64 of the FLAT x402 envelope: payload holds the six EIP-3009 fields from, to, value, validAfter, validBefore, nonce; the EIP-712 signature sits on top. Send it after the 402." }, { "in": "header", "name": "X-PAYMENT", "required": false, "schema": { "type": "string" }, "description": "The same FLAT envelope as X-PAYMENT-AUTH, accepted alongside for backward compatibility." }, { "in": "header", "name": "Payment-Signature", "required": false, "schema": { "type": "string" }, "description": "Standard x402 v2 payment signature header carrying base64 envelope." }, { "in": "header", "name": "X-No-Trial", "required": false, "schema": { "type": "string", "enum": [ "1" ] }, "description": "Set to 1 to bypass free evaluation calls and receive the 402 challenge immediately." } ], "responses": { "200": { "description": "firewall verdict", "content": { "application/json": { "schema": { "type": "object" } } }, "headers": { "X-Free-Trial": { "description": "true when this 200 was served as a free evaluation call, unbilled (the body carries paid:false, trial:true)", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Free-Trial-Remaining": { "description": "evaluation calls left for this IP today, after this one", "schema": { "type": "string" } }, "X-Payment-Settled": { "description": "true when this 200 was served against a verified payment; never present together with X-Free-Trial", "schema": { "type": "string", "enum": [ "true" ] } }, "X-Payment-Tx": { "description": "transaction hash of the settled payment", "schema": { "type": "string" } } } }, "402": { "description": "Payment required: 20000 USDC base units (0.02 USDC), scheme exact on eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x71DEAc098914A009E3720524642A6bE6F65EE528. Sign EIP-712 TransferWithAuthorization (domain {name:\"USD Coin\",version:\"2\",chainId:8453,verifyingContract:\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}) with to=0x71DEAc098914A009E3720524642A6bE6F65EE528 and value = the route amount. Retry with header X-PAYMENT-AUTH: base64(JSON({x402Version:2,scheme:\"exact\",network:\"eip155:8453\",payload:{from,to,value,validAfter,validBefore,nonce},signature})) - the six fields flat in payload, the signature on top of the envelope. X-PAYMENT may carry the same envelope alongside, for backward compatibility. SDK: @celorodrigues/agentkit-firewall@1.0.2. NO ETH required.", "x-x402-terms": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "20000" }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "accepts": { "type": "array", "items": { "type": "object" } } } } } } } }, "security": [ { "x402Payment": [] } ], "x-payment-info": { "protocols": [ "x402" ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "amount": "20000" } } }, "/v2/verify": { "get": { "summary": "Verify attestation (free)", "responses": { "200": { "description": "verification", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v2/pubkey": { "get": { "summary": "Public key (free)", "responses": { "200": { "description": "pubkey", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v2/ledger": { "get": { "summary": "Read ledger (free)", "responses": { "200": { "description": "entries", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v2/treasury/balance": { "get": { "summary": "On-chain Base treasury balances and revenue telemetry (free)", "responses": { "200": { "description": "treasury balances", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v2/pulse": { "get": { "summary": "Base L2 pulse, social bulletins, and live network metrics (free)", "responses": { "200": { "description": "pulse telemetry", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v2/pulse/history": { "get": { "summary": "Historical archive of signed Base L2 pulses (free)", "responses": { "200": { "description": "pulse history", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/v2/pulse/feed": { "get": { "summary": "Markdown syndication feed of recent social broadcasts (free)", "responses": { "200": { "description": "Markdown feed", "content": { "text/markdown": {} } } } } } }, "x-x402": { "payTo": "0x71DEAc098914A009E3720524642A6bE6F65EE528", "network": "eip155:8453", "chainId": 8453, "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "scheme": "exact", "defaultAmountBaseUnits": "1000", "amountPerRoute": "each paid operation's 402 x-x402-terms", "header": "X-PAYMENT-AUTH", "alsoAccepted": "X-PAYMENT", "envelope": "flat", "sdk": "@celorodrigues/agentkit-firewall@1.0.2", "freeTrial": { "callsPerDay": 3, "per": "ip", "servedAs": "HTTP 200 with X-Free-Trial: true; the body carries paid:false and trial:true", "remainingHeader": "X-Free-Trial-Remaining", "skipsTrial": "X-No-Trial: 1 (ask for the 402 directly instead of spending an evaluation call)", "whenExhausted": "HTTP 402 with accepts[] and x-x402-terms for the route amount", "evaluationPath": [ "Call any paid route below with no payment header -> 200, X-Free-Trial: true, X-Free-Trial-Remaining: 2", "Repeat until the daily quota for the IP is spent (each call is a complete, real answer, not a sample)", "Then the route answers 402 with accepts[]; sign the EIP-712 authorization and retry with X-PAYMENT-AUTH" ], "meteredBy": "GET /stats -> funnel.stages, funnel.conversionsPct (a real rate) and funnel.crossWindowPct (a bound across unequal windows); funnel.paidSince/paidLegacy split the counter window from the history paidCalls still carries", "note": "An evaluation call is never billed and never settles on-chain. paidCalls covers the whole history while the settlement counters start at paymentCountersSince: payment conversions use only the counter window (paidSince = settledCalls + queuedCalls) and the pre-counter calls are published as paidLegacy instead of being folded into a rate." } } }