Signal API reference

Interactive reference for Signal's tenant-scoped standing surface: signed receipts, score history, review posture, and portfolio artifacts, plus SDK snippets in TypeScript and Python.

Loading…

Signal at a glance

Signal turns verified settlement history into tenant-scoped standing artifacts. Use this API to retrieve signed operator receipts, inspect score movement, triage review posture, and export signed portfolio snapshots for partner or audit workflows.

GET /reputation/{operator_did} returns the signed receipt for one operator.
GET /signal/v1/operators/{operator_did}/trend and /review-status expose score history and current review posture.
GET /signal/v1/portfolio/summary and /signed-export expose tenant-wide rollups and portable artifacts.

Signal is a private tenant surface, not a public leaderboard. Start with Paybond Signal · Signal scoring · Errors

SDK usage

Excerpt from the Kit quickstarts: open an organization-scoped session through Gateway, then continue with Kit-based requests. Use the interactive reference for request and response details. TypeScript · Python

paybond-session.ts

Code exampleSwipe to inspect long lines

import { Paybond } from "@paybond/kit";

const paybond = await Paybond.open({
  apiKey: process.env.PAYBOND_API_KEY!,
  expectedEnvironment: "sandbox",
});

try {
  const instrumented = await paybond.instrument({
    policy: "./paybond.policy.yaml", // or preset id "travel"
    tools: {
      premium_search: (input) => paidProvider.search(input),
    },
    sandbox: true, // local dev: immediate sandbox runtime; omit for deferred production bind
  });
  const tools = instrumented.tools;

  // Register `tools` with your agent runtime (OpenAI, LangGraph, MCP, custom).
  // Production: omit sandbox; call instrumented.bind({ intentId, capabilityToken }) per session.
} finally {
  await paybond.aclose();
}

import { Paybond } from "@paybond/kit";

const paybond = await Paybond.open({
  apiKey: process.env.PAYBOND_API_KEY!,
  expectedEnvironment: "sandbox",
});

try {
  const instrumented = await paybond.instrument({
    policy: "./paybond.policy.yaml", // or preset id "travel"
    tools: {
      premium_search: (input) => paidProvider.search(input),
    },
    sandbox: true, // local dev: immediate sandbox runtime; omit for deferred production bind
  });
  const tools = instrumented.tools;

  // Register `tools` with your agent runtime (OpenAI, LangGraph, MCP, custom).
  // Production: omit sandbox; call instrumented.bind({ intentId, capabilityToken }) per session.
} finally {
  await paybond.aclose();
}

Need the broader API overview?

See /docs/api for shared authentication, versioning, idempotency, and error behavior across Harbor, Gateway, and Signal.