Trust OS

Docs Playground Ops Demo GitHub SDK

DEVELOPER PLAYGROUND

Trust OS API Playground

Test the Decision Verification API with live requests, structured inputs, and verifiable responses.

Use this playground to inspect the request and response shape before integrating Trust OS into your application.

Live responses are shown when credentials are configured. Sandbox responses preserve the same structure for integration planning.

★ GitHub 📦 npm 📖 Docs 🧪 Ops Demo

1Prepare Request

→

2Send to Trust OS

→

3Verify Decision

→

4Receive JSON Response

→

5Copy / Integrate

API Mode Ready

Endpoint POST /v1/decision/run

SDK @trust-os-sdk/trust-os-sdk

Response Shape Stable

Request ID —

Mode: Live API Auto Sandbox Preview

API Request

Quick Presets

Stablecoin Payment

Cross-border USDC transfer

AI Agent Action

High-impact tool use gate

DAO Treasury

Governance disbursement

Use Case

Decision Payload

Source System

Risk Priority

Counterparty / Destination

API: POST /v1/decision/run

Request Payload

application/json

Request Headers

Content-Type application/json

x-api-key YOUR_API_KEY

Decision Output

▶

Send a request to see a verified decision response.

Request Lifecycle

Request
prepared

API call
sent

Policy
evaluated

Proof
generated

Response
ready

Execution Timeline

request.created —

request.sent —

policy.evaluated —

proof.generated —

response.ready —

Latency Breakdown

Network—

Policy—

Proof—

Render—

Decision

—

Risk Level

—

Risk Score

—

Latency

—

Proof Hash

—

Request ID

—

API Latency

—

Proxy Latency

—

Mode

—

Last Request

—

Recommendation

—

Raw JSON Response

Awaiting request

{
  "decision_id": "—",
  "recommendation": "—",
  "risk_score": null,
  "risk_level": "—",
  "policy": "—",
  "proof_hash": "—",
  "verified": false,
  "latency_ms": null
}

Response Contract

Stable response fields guaranteed by the Trust OS Decision Verification API. These fields are present in both live and sandbox responses.

Field	Type	Description
decision_id	string	Unique identifier for this verification event
recommendation	string	APPROVE · REVIEW · DENY
risk_score	number	0.0 – 1.0 policy evaluation score
risk_level	string	LOW · MEDIUM · HIGH
policy	string	Name of the policy applied to this decision
proof_hash	string	SHA-256 cryptographic verification proof
latency_ms	number	API evaluation latency in milliseconds
mode	string	"sandbox" when live API is unavailable

Developer Resources

SDK, API reference, and code examples for integrating the Trust OS Decision Verification API.

Install SDK

npm install @trust-os-sdk/trust-os-sdk

Production API

POST /v1/decision/verify

Decision Verification API ↗

GitHub

trustos-trustfolio/trustos-sdk ↗

npm

@trust-os-sdk/trust-os-sdk ↗

Operational Demo

ops.trust-os.io ↗

Financial Decision Verification

Code Examples

const { TrustOSClient } = require("@trust-os-sdk/trust-os-sdk");

const client = new TrustOSClient({
  apiKey: process.env.TRUST_OS_API_KEY
});

const result = await client.verifyDecision({
  action: "stablecoin_transfer",
  amount: 50000,
  currency: "USDC",
  destination: "wallet_abc"
});

import requests
import os

response = requests.post(
    "https://trustos-core-gateway-v2-7jm9owrs.an.gateway.dev/v1/decision/verify",
    headers={
        "Content-Type": "application/json",
        "x-api-key": os.environ["TRUST_OS_API_KEY"],
    },
    json={
        "action": "stablecoin_transfer",
        "amount": 50000,
        "currency": "USDC",
        "destination": "wallet_abc",
    },
)

print(response.json())

package main

import (
  "bytes"
  "fmt"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
    "action": "stablecoin_transfer",
    "amount": 50000,
    "currency": "USDC",
    "destination": "wallet_abc"
  }`)

  req, _ := http.NewRequest(
    "POST",
    "https://trustos-core-gateway-v2-7jm9owrs.an.gateway.dev/v1/decision/verify",
    bytes.NewBuffer(body),
  )

  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("x-api-key", os.Getenv("TRUST_OS_API_KEY"))

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()

  fmt.Println(res.Status)
}

POST /v1/decision/verify
Host: trustos-core-gateway-v2-7jm9owrs.an.gateway.dev
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "action": "stablecoin_transfer",
  "amount": 50000,
  "currency": "USDC",
  "destination": "wallet_abc"
}

curl -X POST https://trustos-core-gateway-v2-7jm9owrs.an.gateway.dev/v1/decision/verify \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "action": "stablecoin_transfer",
    "amount": 50000,
    "currency": "USDC",
    "destination": "wallet_abc"
  }'

One API, multiple verification workflows

Use Cases

Verify high-impact decisions before execution — across payments, AI agents, and governance.

Stablecoin Payment Verification

Verify cross-border stablecoin transfers against compliance and risk policy before on-chain execution.

AI Agent Action Verification

Gate high-impact agent tool use — writes, API calls, code execution — with a pre-execution decision check.

DAO Treasury Verification

Validate governance parameters before treasury disbursements — quorum, timelock, multisig.

Compliance Workflow Approval

Route decisions through policy evaluation for regulated industries: finance, healthcare, legal.

EARLY ACCESS

Start Building with Trust OS

Integrate the Decision Verification API into payment infrastructure, AI agent systems, treasury platforms, and compliance workflows.

Trust OS is in private beta. API keys are provisioned by invitation.

Request API Access

Typical onboarding: Intro → Sandbox API → Pilot → Production