AgentPay Pre-Trade Risk Check

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "asset": "USDC",
  "error": "Payment required",
  "pay_to": "GB7THTEVT2T7CZQ5TFUOIQSI32XCJ7BHWS35OBTAI2V4FNL7BXZZ2GM2",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2",
        "assetTransferMethod": "eip3009"
      },
      "payTo": "0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:8453",
      "mimeType": "application/json",
      "resource": "https://agentpay.tools/tools/pre_trade_check/call",
      "description": "One-call pre-trade sanity check: 'I want to long $X of SYMBOL — is now sane?' Combines live orderbook slippage at YOUR size, cross-exchange funding (carry cost), open-interest crowding, and contract security (GoPlus) into a single ok/caution/avoid verdict with a per-factor breakdown. Major ERC-20 addresses (LINK, UNI, ARB, OP, AAVE, PEPE, SHIB) resolve automatically; native assets (BTC, ETH, SOL, ...) report security n/a; an unrecognized token without token_address reads 'unknown' and caps the verdict at caution — an unscreened contract can never read 'ok'. Replaces four API integrations and the judgment layer on top of them. Raw component data embedded so you can apply your own thresholds.",
      "maxAmountRequired": "10000",
      "maxTimeoutSeconds": 300
    }
  ],
  "network": "mainnet",
  "resource": {
    "url": "https://agentpay.tools/tools/pre_trade_check/call",
    "tags": [
      "trading",
      "trade",
      "risk",
      "slippage",
      "pre-trade-check"
    ],
    "mimeType": "application/json",
    "description": "Pre-trade risk check for AI agents trading crypto: live orderbook slippage at YOUR size, side-aware funding carry, open-interest crowding, and optional contract security — composed into a single ok/caution/avoid verdict with per-factor reasons and raw data embedded. Answers 'is this trade sane?' before trading, not after. Replaces four API integrations plus the judgment layer.",
    "serviceName": "AgentPay Pre-Trade Risk Check"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "parameters": {
              "side": "long",
              "symbol": "ETH",
              "size_usd": 50000
            }
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "errors": [
          {
            "body": {
              "error": "<summary>",
              "reason": "<machine-readable reason>"
            },
            "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
            "retry": "Re-request the challenge and pay again",
            "status": 402
          },
          {
            "body": {
              "detail": [
                {
                  "loc": [
                    "body"
                  ],
                  "msg": "<what is wrong>",
                  "type": "<error type>"
                }
              ]
            },
            "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
            "retry": "Fix the body and retry with a fresh payment",
            "status": 422
          },
          {
            "body": {
              "detail": "Tool '<name>' not found"
            },
            "when": "Unknown tool name",
            "status": 404
          },
          {
            "body": {
              "error": "Rate limit exceeded"
            },
            "when": "Rate limited (per-IP and per-wallet limits)",
            "retry": "Back off and retry after a minute",
            "status": 429
          },
          {
            "body": {
              "tool": "<name>",
              "error": "Tool execution failed",
              "payment_status": "refund_pending"
            },
            "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
            "status": 500
          },
          {
            "body": {
              "detail": "<what is unavailable>"
            },
            "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
            "retry": "Retry shortly",
            "status": 503
          }
        ],
        "output": {
          "type": "json",
          "example": {
            "side": "long",
            "symbol": "ETH",
            "factors": {
              "carry": {
                "level": "ok",
                "reason": "carry unremarkable",
                "median_funding_pct": 0.01
              },
              "crowding": {
                "level": "ok",
                "reason": "positioning unremarkable",
                "long_short_ratio": 1.2
              },
              "security": {
                "level": "skipped",
                "reason": "no token_address provided"
              },
              "liquidity": {
                "level": "ok",
                "reason": "fills within 0.001% of best price",
                "slippage_pct": 0.001
              }
            },
            "verdict": "ok",
            "size_usd": 50000
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "bodyType",
              "body",
              "method"
            ],
            "properties": {
              "body": {
                "type": "object",
                "properties": {
                  "parameters": {
                    "type": "object",
                    "required": [
                      "symbol"
                    ],
                    "properties": {
                      "side": {
                        "enum": [
                          "long",
                          "short"
                        ],
                        "type": "string",
                        "description": "Trade direction (funding carry is side-aware; default long)"
                      },
                      "symbol": {
                        "type": "string",
                        "description": "Asset to check, e.g. 'ETH', 'BTC', 'SOL'"
                      },
                      "size_usd": {
                        "type": "number",
                        "description": "Intended position size in USD (drives the slippage check; default 10000)"
                      },
                      "token_address": {
                        "type": "string",
                        "description": "Optional ERC-20 address — adds a GoPlus security scan"
                      }
                    }
                  }
                }
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object"
              }
            }
          }
        }
      },
      "description": "Pre-trade risk check for AI agents trading crypto: 'I want to long $X of SYMBOL — is now sane?' Live slippage at your size + side-aware funding carry + OI crowding + optional security scan → one ok/caution/avoid verdict with per-factor breakdown and raw components embedded."
    }
  },
  "payment_id": "10b105f0-10db-47e8-a1bf-a062d5448b2a",
  "amount_usdc": "0.01",
  "x402Version": 2,
  "instructions": "[Stellar] Send 0.01 USDC to GB7THTEVT2T7CZQ5TFUOIQSI32XCJ7BHWS35OBTAI2V4FNL7BXZZ2GM2 on Stellar mainnet with text memo: 10b105f0-10db-47e8-a1bf-a062 (the payment_id's first 28 bytes — a Stellar text memo cannot hold more). Retry with X-Payment: tx_hash=<hash>,from=<addr>,id=10b105f0-10db-47e8-a1bf-a062d5448b2a. No Stellar wallet? Get a free funded testnet wallet instantly: https://agentpay.tools/faucet",
  "payment_options": {
    "base": {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "pay_to": "0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7",
      "scheme": "exact",
      "network": "eip155:8453",
      "amount_usdc": "0.01",
      "instructions": "Sign an EIP-3009 transferWithAuthorization for the amount above, encode as base64 JSON PaymentPayload, and retry with header PAYMENT-SIGNATURE: <base64_payload>",
      "amount_atomic": "10000",
      "maxTimeoutSeconds": 300
    },
    "stacks": {
      "asset": "sbtc",
      "header": "payment-signature: <base64(StacksPaymentPayload JSON)>",
      "pay_to": "SP23XKWSEQ9D4CVPT0H39N2TYVEE5AJECPKW6CZ3C",
      "scheme": "exact",
      "network": "stacks:1",
      "amount_sats": 13,
      "amount_usdc": "0.01",
      "btc_usd_rate": "77675",
      "fee_microstx": 3000
    },
    "stellar": {
      "memo": "10b105f0-10db-47e8-a1bf-a062",
      "note": "Classic Stellar payment + text memo (the payment_id's first 28 bytes, which is all a text memo holds), verified via Horizon — not the standard @x402/stellar Soroban scheme. Pay with the AgentPay SDK (pip install agentpay-x402) or manually per instructions.",
      "asset": "USDC",
      "header": "X-Payment: tx_hash=<hash>,from=<addr>,id=10b105f0-10db-47e8-a1bf-a062d5448b2a",
      "pay_to": "GB7THTEVT2T7CZQ5TFUOIQSI32XCJ7BHWS35OBTAI2V4FNL7BXZZ2GM2",
      "scheme": "agentpay-classic-memo",
      "network": "mainnet",
      "payment_id": "10b105f0-10db-47e8-a1bf-a062d5448b2a",
      "amount_usdc": "0.01"
    }
  }
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2",
      "assetTransferMethod": "eip3009"
    },
    "payTo": "0xE8B25A72dD6aeF69515452a61AD231C7DF2843b7",
    "amount": "10000",
    "scheme": "exact",
    "network": "eip155:8453",
    "mimeType": "application/json",
    "resource": "https://agentpay.tools/tools/pre_trade_check/call",
    "description": "One-call pre-trade sanity check: 'I want to long $X of SYMBOL — is now sane?' Combines live orderbook slippage at YOUR size, cross-exchange funding (carry cost), open-interest crowding, and contract security (GoPlus) into a single ok/caution/avoid verdict with a per-factor breakdown. Major ERC-20 addresses (LINK, UNI, ARB, OP, AAVE, PEPE, SHIB) resolve automatically; native assets (BTC, ETH, SOL, ...) report security n/a; an unrecognized token without token_address reads 'unknown' and caps the verdict at caution — an unscreened contract can never read 'ok'. Replaces four API integrations and the judgment layer on top of them. Raw component data embedded so you can apply your own thresholds.",
    "outputSchema": {
      "input": {
        "type": "object",
        "required": [
          "symbol"
        ],
        "properties": {
          "side": {
            "enum": [
              "long",
              "short"
            ],
            "type": "string",
            "default": "long",
            "description": "Trade direction (funding carry is side-aware)"
          },
          "symbol": {
            "type": "string",
            "description": "Asset to check, e.g. 'ETH', 'BTC', 'SOL'"
          },
          "size_usd": {
            "type": "number",
            "default": 10000,
            "description": "Intended position size in USD (drives the slippage check)"
          },
          "token_address": {
            "type": "string",
            "description": "Optional ERC-20 contract address for the GoPlus security scan. Auto-resolved for major tokens; required for a full verdict on tokens the resolver doesn't know (otherwise security reads 'unknown' and caps the verdict at caution)"
          }
        }
      },
      "errors": [
        {
          "body": {
            "error": "<summary>",
            "reason": "<machine-readable reason>"
          },
          "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
          "retry": "Re-request the challenge and pay again",
          "status": 402
        },
        {
          "body": {
            "detail": [
              {
                "loc": [
                  "body"
                ],
                "msg": "<what is wrong>",
                "type": "<error type>"
              }
            ]
          },
          "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
          "retry": "Fix the body and retry with a fresh payment",
          "status": 422
        },
        {
          "body": {
            "detail": "Tool '<name>' not found"
          },
          "when": "Unknown tool name",
          "status": 404
        },
        {
          "body": {
            "error": "Rate limit exceeded"
          },
          "when": "Rate limited (per-IP and per-wallet limits)",
          "retry": "Back off and retry after a minute",
          "status": 429
        },
        {
          "body": {
            "tool": "<name>",
            "error": "Tool execution failed",
            "payment_status": "refund_pending"
          },
          "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
          "status": 500
        },
        {
          "body": {
            "detail": "<what is unavailable>"
          },
          "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
          "retry": "Retry shortly",
          "status": 503
        }
      ],
      "output": {
        "side": "long",
        "symbol": "ETH",
        "factors": {
          "carry": {
            "level": "caution",
            "reason": "longs paying elevated funding",
            "annualized_pct": 67.9,
            "median_funding_pct": 0.062
          },
          "crowding": {
            "level": "ok",
            "reason": "positioning unremarkable",
            "long_short_ratio": 1.4,
            "oi_change_24h_pct": 3.2
          },
          "security": {
            "level": "skipped",
            "reason": "no token_address provided"
          },
          "liquidity": {
            "level": "ok",
            "reason": "fills within 0.011% of best ask",
            "bucket_usd": 50000,
            "slippage_pct": 0.011
          }
        },
        "verdict": "caution",
        "size_usd": 50000
      }
    },
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "parameters": {
            "side": "long",
            "symbol": "ETH",
            "size_usd": 50000
          }
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      },
      "errors": [
        {
          "body": {
            "error": "<summary>",
            "reason": "<machine-readable reason>"
          },
          "when": "No payment attached (this challenge), or the attached payment failed verification: wrong amount/recipient, memo mismatch, expired, or already used (replay)",
          "retry": "Re-request the challenge and pay again",
          "status": 402
        },
        {
          "body": {
            "detail": [
              {
                "loc": [
                  "body"
                ],
                "msg": "<what is wrong>",
                "type": "<error type>"
              }
            ]
          },
          "when": "Request body present but malformed (invalid JSON or wrong field types) WITH a payment header attached — checked BEFORE settlement, so the payment is never consumed. An unpaid malformed request gets the 402, not a 422",
          "retry": "Fix the body and retry with a fresh payment",
          "status": 422
        },
        {
          "body": {
            "detail": "Tool '<name>' not found"
          },
          "when": "Unknown tool name",
          "status": 404
        },
        {
          "body": {
            "error": "Rate limit exceeded"
          },
          "when": "Rate limited (per-IP and per-wallet limits)",
          "retry": "Back off and retry after a minute",
          "status": 429
        },
        {
          "body": {
            "tool": "<name>",
            "error": "Tool execution failed",
            "payment_status": "refund_pending"
          },
          "when": "Payment settled on-chain but tool execution failed — the payment is marked refund_pending automatically; you are not charged for a failed call",
          "status": 500
        },
        {
          "body": {
            "detail": "<what is unavailable>"
          },
          "when": "Tool temporarily unavailable, or the gateway cannot persist the challenge (fail-closed)",
          "retry": "Retry shortly",
          "status": 503
        }
      ],
      "output": {
        "type": "json",
        "example": {
          "side": "long",
          "symbol": "ETH",
          "factors": {
            "carry": {
              "level": "ok",
              "reason": "carry unremarkable",
              "median_funding_pct": 0.01
            },
            "crowding": {
              "level": "ok",
              "reason": "positioning unremarkable",
              "long_short_ratio": 1.2
            },
            "security": {
              "level": "skipped",
              "reason": "no token_address provided"
            },
            "liquidity": {
              "level": "ok",
              "reason": "fills within 0.001% of best price",
              "slippage_pct": 0.001
            }
          },
          "verdict": "ok",
          "size_usd": 50000
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "bodyType",
            "body",
            "method"
          ],
          "properties": {
            "body": {
              "type": "object",
              "properties": {
                "parameters": {
                  "type": "object",
                  "required": [
                    "symbol"
                  ],
                  "properties": {
                    "side": {
                      "enum": [
                        "long",
                        "short"
                      ],
                      "type": "string",
                      "description": "Trade direction (funding carry is side-aware; default long)"
                    },
                    "symbol": {
                      "type": "string",
                      "description": "Asset to check, e.g. 'ETH', 'BTC', 'SOL'"
                    },
                    "size_usd": {
                      "type": "number",
                      "description": "Intended position size in USD (drives the slippage check; default 10000)"
                    },
                    "token_address": {
                      "type": "string",
                      "description": "Optional ERC-20 address — adds a GoPlus security scan"
                    }
                  }
                }
              }
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    },
    "description": "Pre-trade risk check for AI agents trading crypto: 'I want to long $X of SYMBOL — is now sane?' Live slippage at your size + side-aware funding carry + OI crowding + optional security scan → one ok/caution/avoid verdict with per-factor breakdown and raw components embedded."
  }
}

Provenance

Seen in the source catalog

2026-09-21 18:40Z

Last indexed by Roundhouse

2026-09-24 22:10Z

Last enriched (probe, favicon, geo)

2026-09-14 13:15Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 402