Tgov Coordinate

{
  "agents": [
    {
      "allowed_usd": 0,
      "id": "desk-alpha",
      "mandate_usd": 100000,
      "reasons": [
        "v30-pause-high matched: volatility_pct 42 is above 30 and tier 5 >= 4, so this agent is PAUSED and allowed to deploy 0.",
        "v15-cap-high also matched (cap) but a PAUSED agent is not reopened by a milder rule."
      ],
      "requested_usd": 80000,
      "risk_tier": 5,
      "status": "PAUSED"
    },
    {
      "allowed_usd": 20000,
      "id": "desk-beta",
      "mandate_usd": 50000,
      "reasons": [
        "No rule matched tier 2.",
        "Requested 20000 sits inside mandate 50000, so allowed is 20000."
      ],
      "requested_usd": 20000,
      "risk_tier": 2,
      "status": "CLEAR"
    },
    {
      "allowed_usd": 0,
      "id": "desk-gamma",
      "mandate_usd": 40000,
      "reasons": [
        "v30-pause-high matched: volatility_pct 42 is above 30 and tier 4 >= 4, so this agent is PAUSED and allowed to deploy 0.",
        "v15-cap-high also matched (cap) but a PAUSED agent is not reopened by a milder rule."
      ],
      "requested_usd": 45000,
      "risk_tier": 4,
      "status": "PAUSED"
    }
  ],
  "assumptions": [
    "This is a governance screen, not an oracle — outputs are the engine enforcing the rules you gave it, nothing more.",
    "Rule violation rate is zero by construction because TGOV refuses what the rules forbid rather than flagging it after the fact.",
    "The latency win comes from refusing instantly at decision time instead of reconciling breaches later."
  ],
  "audit_log": [
    {
      "at": "2026-10-09T00:00:00Z",
      "detail": "v30-pause-high fired: volatility_pct 42 is above 30, action pause, tiers >= 4, matched 2 agent(s).",
      "event": "rule_fired"
    },
    {
      "at": "2026-10-09T00:00:00Z",
      "detail": "v15-cap-high fired: volatility_pct 42 is above 15, action cap 50%, tiers >= 4, matched 2 agent(s).",
      "event": "rule_fired"
    },
    {
      "at": "2026-10-09T00:00:00Z",
      "detail": "desk-alpha status PAUSED, requested 80000 → allowed 0. v30-pause-high matched: volatility_pct 42 is above 30 and tier 5 >= 4, so this agent is PAUSED and allowed to deploy 0. v15-cap-high also matched (cap) but a PAUSED agent is not reopened by a milder rule.",
      "event": "agent_decision"
    },
    {
      "at": "2026-10-09T00:00:00Z",
      "detail": "desk-beta status CLEAR, requested 20000 → allowed 20000. No rule matched tier 2. Requested 20000 sits inside mandate 50000, so allowed is 20000.",
      "event": "agent_decision"
    },
    {
      "at": "2026-10-09T00:00:00Z",
      "detail": "desk-gamma status PAUSED, requested 45000 → allowed 0. v30-pause-high matched: volatility_pct 42 is above 30 and tier 4 >= 4, so this agent is PAUSED and allowed to deploy 0. v15-cap-high also matched (cap) but a PAUSED agent is not reopened by a milder rule.",
      "event": "agent_decision"
    },
    {
      "at": "2026-10-09T00:00:00Z",
      "detail": "PAUSED. Worst case across 3 agent(s). Requested 145000, allowed 20000, blocked 125000.",
      "event": "verdict"
    }
  ],
  "market_state": {
    "liquidity_pct": 55,
    "volatility_pct": 42
  },
  "rationale": "PAUSED. Volatility is 42% and liquidity is 55%, so 2 of 3 agents are paused and deploy nothing. No agent is frozen, and a later cap does not reopen a pause. Capital: of 145000 requested, 20000 is allowed and 125000 is blocked (fired rules: v30-pause-high, v15-cap-high).",
  "rules_effective": [
    {
      "action": "cap",
      "applies_to_tiers_at_or_above": 4,
      "cap_pct": 50,
      "default_pack": true,
      "direction": "above",
      "id": "v15-cap-high",
      "metric": "volatility_pct",
      "threshold": 15
    },
    {
      "action": "pause",
      "applies_to_tiers_at_or_above": 4,
      "default_pack": true,
      "direction": "above",
      "id": "v30-pause-high",
      "metric": "volatility_pct",
      "threshold": 30
    },
    {
      "action": "freeze",
      "applies_to_tiers_at_or_above": 1,
      "default_pack": true,
      "direction": "above",
      "id": "v60-freeze-all",
      "metric": "volatility_pct",
      "threshold": 60
    }
  ],
  "rules_triggered": [
    "v30-pause-high",
    "v15-cap-high"
  ],
  "totals": {
    "allowed": 20000,
    "blocked": 125000,
    "requested": 145000
  },
  "verdict": "PAUSED"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://agentpaystore.com/tgov/api/coordinate' \
  -H 'content-type: application/json' \
  --data-raw '{}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://agentpaystore.com/tgov/api/coordinate' \
  -H 'content-type: application/json' \
  --data-raw '{}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.05 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.05" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.05 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fagentpaystore.com%2Ftgov%2Fapi%2Fcoordinate&method=POST
const res = await pay("https://agentpaystore.com/tgov/api/coordinate", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({}),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.05 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.05"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://agentpaystore.com/tgov/api/coordinate",
        json={},
    )
    print(res.status_code, res.text)