timzinin-com Us Brand Signal Confidence Gate API

openapi: 3.2.0
info:
  title: Zinin M2M Hub Us Brand Signal Confidence Gate API
  description: Pay-per-call data & tool APIs
  version: 1.0.0
  x-guidance: 'Zinin M2M Hub — pay-per-call data & tool APIs for AI agents. Each POST /api/{slug} operation below is a distinct paid tool: call GET /api/{slug}/schema first for the exact input shape, then POST with a signed PAYMENT-SIGNATURE header (x402 v2, USDC — see x-payment-info per operation) or omit it to receive a 402 with full payment requirements in the PAYMENT-REQUIRED header. The same catalog is also available as MCP JSON-RPC tool bundles at POST /mcp/{bundle} — see GET /.well-known/x402 for the list of bundles.'
tags:
- name: Us Brand Signal Confidence Gate
paths:
  /api/us-brand-signal-confidence-gate:
    post:
      summary: US Brand Signal Confidence Gate
      description: Classify buyer-supplied normalized US brand signal scores against explicit accept and review thresholds. Receive sorted accepted, review, and rejected IDs with stable reason codes, counts, and digests; no source or identity claims are made.
      operationId: call_us_brand_signal_confidence_gate
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.050000'
        protocols:
        - x402: {}
        network: eip155:8453
        payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: US Brand Signal Confidence Gate input
              description: Closed inline-only input. Scores are buyer-supplied normalized values; no source is fetched and no identity is inferred.
              type: object
              schemaVersion: 1
              additionalProperties: false
              required:
              - schemaVersion
              - thresholds
              - rows
              properties:
                schemaVersion:
                  title: Contract schema version
                  description: The only supported closed contract version.
                  type: string
                  enum:
                  - '1.0'
                  default: '1.0'
                  prefill: '1.0'
                thresholds:
                  title: Explicit buyer thresholds
                  description: Accept is inclusive at acceptThreshold; review is inclusive from reviewThreshold up to, but excluding, acceptThreshold. The required ordering marker prevents ambiguity.
                  type: object
                  editor: json
                  additionalProperties: false
                  required:
                  - acceptThreshold
                  - reviewThreshold
                  - thresholdOrder
                  properties:
                    acceptThreshold:
                      title: Accept at or above
                      description: Scores at or above this integer are accepted.
                      type: integer
                      minimum: 1
                      maximum: 100
                    reviewThreshold:
                      title: Review at or above
                      description: Scores at or above this integer but below acceptThreshold are sent to review.
                      type: integer
                      minimum: 1
                      maximum: 100
                    thresholdOrder:
                      title: Threshold ordering proof
                      description: Explicitly declares that acceptThreshold must be greater than reviewThreshold.
                      type: string
                      enum:
                      - accept_gt_review
                      default: accept_gt_review
                  prefill:
                    acceptThreshold: 80
                    reviewThreshold: 50
                    thresholdOrder: accept_gt_review
                rows:
                  title: Normalized signal rows
                  description: One to 100 unique signal IDs with integer normalized scores from 1 to 100. IDs are sorted by the runtime before classification.
                  type: array
                  editor: json
                  minItems: 1
                  maxItems: 100
                  items:
                    type: object
                    additionalProperties: false
                    required:
                    - signalId
                    - normalizedSignal
                    properties:
                      signalId:
                        title: Signal ID
                        description: Buyer-supplied stable printable ASCII ID; no person or company identity is inferred.
                        type: string
                        minLength: 1
                        maxLength: 64
                        pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$
                      normalizedSignal:
                        title: Normalized signal
                        description: Buyer-supplied integer score from 1 to 100; it is not independently verified.
                        type: integer
                        minimum: 1
                        maximum: 100
                  prefill:
                  - signalId: signal-001
                    normalizedSignal: 96
                  - signalId: signal-002
                    normalizedSignal: 82
                  - signalId: signal-003
                    normalizedSignal: 61
                  - signalId: signal-004
                    normalizedSignal: 39
      responses:
        '200':
          description: Actor run succeeded and payment settled
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                    description: Actor output items — shape is actor-specific (varies per tool); see this operation's own requestBody schema/description for what the underlying actor produces.
                  meta:
                    type: object
                    properties:
                      run_ms:
                        type: integer
                        description: Actor run duration in milliseconds
                      item_count:
                        type: integer
                        description: len(results)
                      settled:
                        type: boolean
                        description: Whether the x402 payment was confirmed settled by the facilitator
                      transaction:
                        type:
                        - string
                        - 'null'
                        description: On-chain settlement transaction hash, null if unsettled
                    required:
                    - run_ms
                    - item_count
                    - settled
                    - transaction
                required:
                - results
                - meta
        '400':
          description: Malformed PAYMENT-SIGNATURE header or request body
        '402':
          description: Payment required or invalid — see PAYMENT-REQUIRED header
        '409':
          description: Payment payload already used
        '502':
          description: Actor run failed
        '504':
          description: Actor run timed out
      tags:
      - Us Brand Signal Confidence Gate