# SYNTHORA Pre-Trade Safety API

> SYNTHORA Pre-Trade Safety API is a paid API for AI agents from pre-trade-safety.hergertsynthora.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Checks a blockchain address or token contract for safety flags and risk score before a trade or interaction, returning a signed verdict with confidence level.

## Facts

- Endpoint: POST https://pre-trade-safety.hergertsynthora.com/service
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-pre-trade-safety-api-348ca0fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5CfNZTb4o1knfMLIpbOLr

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

## How to call it through Zero

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

```sh
zero fetch --capability synthora-pre-trade-safety-api-348ca0fb -d '<json body>'
```

Example prompt: Before I buy this token, can you run a pre-trade safety check on the address 0xAbC123... on Base mainnet — I want to see the risk score, any flags, and whether it's cleared for trading?

## When to prefer this

Use this endpoint when an autonomous agent needs a cryptographically attested pre-trade safety verdict for a blockchain address or token, especially in no-KYC, pay-per-call contexts where API key management is impractical. Prefer over generic blockchain explorers when you need a signed, machine-verifiable risk report suitable for automated trade gating.

## Known failure modes

- 402 returned without payment header — expected first-step response, not an error
- Invalid or malformed address causes rejection or empty flags
- Unknown chain identifier returns error or low-confidence result
- Payment authorization fails or is expired, resulting in 402 again
- Address not found in any source returns low-confidence verdict with empty flags

## How this service works

Pay-per-call data and safety intelligence for autonomous agents. Every endpoint is protected by HTTP 402 (x402), settled in USDC on Base mainnet (eip155:8453). No API key, no signup, no KYC: the payment IS the authentication. Responses are Ed25519-signed.

Flow: (1) POST the endpoint with no payment header, (2) receive HTTP 402 with an `accepts` array describing price and payTo, (3) re-POST with the `X-PAYMENT` header carrying an EIP-3009 transferWithAuthorization, (4) receive the signed result.

This document describes the canonical request/response contract. The full live catalogue of 222 payable resources is published at https://pay.hergertsynthora.com/.well-known/x402.json

## Output

A JSON object containing: a boolean ok field, a signed SYNTHORA report (Ed25519 firma + sha256), the subject address, a list of risk flags, data sources used, a confidence level (e.g. 'alta'), a verdict string (e.g. 'APTO_CON_CONDICIONES' or 'RECHAZADO'), and a numeric risk score (0–100).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string"
  },
  "chain": {
   "type": "string"
  },
  "address": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "pre_trade_safety",
  "result": {
   "sello": {
    "firma": "SYNTHORA",
    "sha256": "..."
   },
   "sujeto": "0x..",
   "informe": {
    "flags": [],
    "fuentes": [],
    "confianza": "alta",
    "veredicto": "APTO_CON_CONDICIONES",
    "score_riesgo": 45
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-pre-trade-safety-api-348ca0fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pre-trade-safety.hergertsynthora.com](https://www.zero.xyz/host/pre-trade-safety.hergertsynthora.com/llms.txt)