SNHP

SNHP Notary API

The notary API from SNHP — 2 operation(s) for notary.

Documentation GitHub OpenAPI

Operations 2

GET /v1/notary/key The notary's public signing key (verify quote attestations offline) #

POST /v1/notary/verify Verify notary receipts standalone (signature + discount-only + chain) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/snhp-dev-notary-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Game Theory Layer for AI Agents Notary API
  description: 'Start with ONE tool: POST /v1/negotiate/turn — plain-dollar price negotiation (your walk-away + the other side''s offers in dollars -> the counter to send, a ready-to-send message, accept/walk advice).'
  version: 0.1.0
tags:
- name: notary
paths:
  /v1/notary/key:
    get:
      tags:
      - notary
      summary: The notary's public signing key (verify quote attestations offline)
      description: Returns the Ed25519 PUBLIC key that signs SNHP notary receipts — the `attestation` block on /v1/offer/quote and any receipt POSTed to /v1/notary/verify. `key_source` is 'env' (a persistent key set via NOTARY_KEY_PEM — signatures survive restarts) or 'ephemeral' (a fresh per-process key — historical signatures become unverifiable across a restart). The private key never leaves the server.
      operationId: notary_key_v1_notary_key_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/notary/verify:
    post:
      tags:
      - notary
      summary: Verify notary receipts standalone (signature + discount-only + chain)
      description: 'Body: a single receipt JSON, a JSON array of receipts, or {"receipts": [...]}. Each receipt is verified STANDALONE — the canonical signature (against the embedded pubkey, or this server''s notary key), the discount-only invariant (p ≤ ℓ) re-checked, and a_prime_ok re-derived from the receipt''s own ℓ/c_eff/β — plus the prev_hash chain across the sequence. No signing key is needed; the same checks run client-side with only GET /v1/notary/key.'
      operationId: notary_verify_v1_notary_verify_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}