# US Brand Signal Policy Simulator

> US Brand Signal Policy Simulator is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Simulates and compares multiple brand-safety scoring policies against buyer-supplied signal scores, returning accept/review/reject classifications and cross-policy divergence counts for US brand signals.

## Facts

- Endpoint: POST https://api.timzinin.com/api/us-brand-signal-policy-simulator
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-brand-signal-policy-simulator-5380f07f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qgC6mBq51pIH-_EvHsojy

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 us-brand-signal-policy-simulator-5380f07f -d '<json body>'
```

Example prompt: Simulate three brand signal policies — balanced (accept at 80, review at 50), broad (accept at 70, review at 30), and strict (accept at 90, review at 60) — against my 4 scored US brand signals (signal-001: 92, signal-002: 85, signal-003: 55, signal-004: 35) and show me how many signals each policy accepts, rejects, or routes to review, plus where they disagree with each other.

## When to prefer this

Use this endpoint when you need to compare the downstream effects of different brand-safety threshold policies on a known set of scored signals before committing to a policy in production. It is ideal for buyers who already have their own scored signals and want to stress-test or audit policy choices without any external truth-claim or recommendation — the simulator is purely deterministic against buyer-supplied inputs.

## Known failure modes

- Invalid or missing signal scores cause validation error
- Threshold values out of range (e.g. accept threshold below review threshold) may return an error
- Malformed policy definitions cause a 400-level response
- Empty signal list returns zero-count results with valid structure
- Network timeout on heavy input sets (run_ms may exceed SLA)

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON object with per-policy classification counts (accepted, reviewed, rejected) and IDs, pairwise cross-policy comparison metrics (changed signal count, decisions only in A vs B), row/input/result digests for auditability, and an attribution note clarifying the simulation makes no winner recommendation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "signalId",
     "normalizedScore"
    ],
    "properties": {
     "signalId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
      "maxLength": 64,
      "minLength": 1
     },
     "normalizedScore": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100,
   "minItems": 1
  },
  "policies": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "policyId",
     "reviewThreshold",
     "acceptThreshold",
     "thresholdOrder"
    ],
    "properties": {
     "policyId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
      "maxLength": 64,
      "minLength": 1
     },
     "thresholdOrder": {
      "enum": [
       "review_lt_accept"
      ],
      "type": "string"
     },
     "acceptThreshold": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
     },
     "reviewThreshold": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20,
   "minItems": 1
  },
  "schemaVersion": {
   "enum": [
    "1.0"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "counts": {
     "rows": 4,
     "policies": 3,
     "comparisons": 3,
     "sensitivityRows": 4
    },
    "totalRows": 4,
    "reportType": "us_brand_signal_policy_simulator",
    "rowsDigest": "911caadd6dc1c410ed601d2b580171dbb229935e8832de4b6a72a6747fcac4a5",
    "attribution": {
     "type": "buyer_supplied_scores_and_policies",
     "meaning": "Rows and thresholds were supplied by the buyer; this Actor simulates the stated policies only and makes no truth claim, recommendation, or winner selection."
    },
    "comparisons": [
     {
      "policyA": "balanced",
      "policyB": "broad",
      "reviewOnlyInA": 0,
      "reviewOnlyInB": 1,
      "acceptedOnlyInA": 0,
      "acceptedOnlyInB": 0,
      "rejectedOnlyInA": 1,
      "rejectedOnlyInB": 0,
      "sameDecisionCount": 3,
      "changedSignalCount": 1
     },
     {
      "policyA": "balanced",
      "policyB": "strict",
      "reviewOnlyInA": 1,
      "reviewOnlyInB": 1,
      "acceptedOnlyInA": 1,
      "acceptedOnlyInB": 0,
      "rejectedOnlyInA": 0,
      "rejectedOnlyInB": 1,
      "sameDecisionCount": 2,
      "changedSignalCount": 2
     },
     {
      "policyA": "broad",
      "policyB": "strict",
      "reviewOnlyInA": 2,
      "reviewOnlyInB": 1,
      "acceptedOnlyInA": 1,
      "acceptedOnlyInB": 0,
      "rejectedOnlyInA": 0,
      "rejectedOnlyInB": 2,
      "sameDecisionCount": 1,
      "changedSignalCount": 3
     }
    ],
    "inputDigest": "cb1a39d72bddee8ad1a44f025db9f4a6a1f513ea6a86d094f1d0fe483444d291",
    "resultDigest": "1be9ae6e4daebcd67c8960b9aa6f2bbd14d6121f497d7f7635d120d2fe97a493",
    "policyResults": [
     {
      "counts": {
       "total": 4,
       "review": 1,
       "accepted": 2,
       "rejected": 1
      },
      "policyId": "balanced",
      "reviewIds": [
       "signal-003"
      ],
      "acceptedIds": [
       "signal-001",
       "signal-002"
      ],
      "rejectedIds": [
       "signal-004"
      ],
      "acceptThreshold": 80,
      "reviewThreshold": 50,
      "classificationDigest": "f40bc496a84f4d6504946cdaa8825468a26066d320a1fc6fed3fdbe3b1dbc0ff"
     },
     {
      "counts": {
       "total": 4,
       "review": 2,
       "accepted": 2,
       "rejected": 0
      },
      "policyId": "broad",
      "reviewIds": [
       "signal-003",
       "signal-004"
      ],
      "acceptedIds": [
       "signal-001",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-brand-signal-policy-simulator-5380f07f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)