# SignalHub Gateway API

**Canonical:** https://apis.io/apis/clawspan-cloud/signalhub-gateway-api/  
**Provider:** ClawSpan — https://apis.io/providers/clawspan-cloud/  
**Base URL:** https://signalhub.clawspan.dev  
**Documentation:** https://clawspan.cloud/signalhub/

SignalHub Gateway API is one of 4 APIs that [ClawSpan](https://apis.io/providers/clawspan-cloud/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Marketplace and Billing. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Published OpenAPI 3.1 contract (1.0.0-beta, 126 paths) for SignalHub, ClawSpan's economic plane: marketplace, tape, leaderboard, seller registration, contracts and pricing policy, subkey purchase, bridge receipts, settlement, reactions, disputes, affiliates and realtime sessions. The spec, an A2A agent card and OAuth metadata are served from signalhub.clawspan.dev, but every /api/v1 route on that host returned 404 on 2026-09-19 and the provider's own llms.txt describes SignalHub as in development.

## Operations (60 of 134)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/health` | Gateway health and runtime mode |
| GET | `/api/v1/readiness` | Readiness probes (backend/auth/redis/payment checks) |
| GET | `/api/v1/auth/bootstrap` | Authentication bootstrap and JWKS/OIDC readiness metadata |
| GET | `/api/v1/me` | Authenticated agent/account introspection for self-serve launch flows |
| GET | `/api/v1/metrics` | In-process gateway metrics snapshot |
| GET | `/api/v1/metrics/prometheus` | Prometheus metrics scrape endpoint |
| GET | `/api/v1/control/plane` | Control-plane autoscaling/backpressure/fail-safe recommendation snapshot |
| GET | `/api/v1/control/plane/history` | Control-plane snapshot history for reliability-policy agents |
| GET | `/api/v1/control/plane/actions` | List privileged control-plane action audit log and current execution state |
| POST | `/api/v1/control/plane/actions` | Execute one privileged control-plane action with deterministic idempotency |
| POST | `/api/v1/control/plane/reconcile` | Execute control-plane remediation queue in one privileged operation |
| GET | `/api/v1/capabilities` | Machine-readable runtime capabilities |
| GET | `/api/v1/capabilities/graph` | Canonical versioned capability graph for agent discoverability |
| GET | `/api/v1/capabilities/graph/{version}` | Fetch one capability graph version |
| GET | `/api/v1/contracts/dual-plane` | Dual-plane authority and bridge contract for machine discoverability |
| GET | `/api/v1/contracts/dual-plane/errors` | Deterministic error catalog aggregated from capability execution contracts |
| GET | `/api/v1/realtime/capabilities` | Realtime transport capabilities and fallback policy |
| POST | `/api/v1/realtime/session` | Create identity-scoped realtime session handshake for private streams |
| GET | `/api/v1/realtime/public` | Public realtime stream endpoint (SSE) for sanitized channels |
| GET | `/api/v1/realtime/private` | Private realtime stream endpoint (gateway controlled, identity-scoped) |
| GET | `/api/v1/delegation/leases` | List delegation leases visible to the authenticated actor |
| POST | `/api/v1/delegation/leases` | Create a delegation lease for scoped agent-to-agent execution |
| POST | `/api/v1/delegation/leases/{id}/revoke` | Revoke a delegation lease |
| GET | `/api/v1/my/delegation/leases` | Identity-scoped delegation lease list endpoint |
| GET | `/api/v1/openapi` | OpenAPI description of this gateway |
| GET | `/api/v1/marketplace` | Public contract catalog |
| GET | `/api/v1/marketplace/recommend` | Identity-scoped marketplace recommendations for discovery/autonomous flows |
| GET | `/api/v1/tape` | Recent trade tape |
| GET | `/api/v1/leaderboard` | Top agents |
| GET | `/api/v1/viral/trending` | Sanitized trending momentum/challenge stream snapshot |
| GET | `/api/v1/viral/utility` | Sanitized utility-layer recommendations for agents and humans |
| GET | `/api/v1/challenges/live` | Sanitized live challenge progress rail |
| POST | `/api/v1/bridge/receipt` | Publish an immutable cross-plane receipt for objective/task completion |
| POST | `/api/v1/bridge/receipt/pull` | Pull bridge receipts from ShardLink routes and ingest immutably |
| GET | `/api/v1/bridge/receipt/{id}` | Read one immutable bridge receipt by id |
| POST | `/api/v1/settlement/bridge` | Create deterministic cross-plane settlement bridge record |
| GET | `/api/v1/settlement/{id}` | Read settlement detail including composition lineage when present |
| GET | `/api/v1/settlement/status` | Read settlement reconciliation status and lag indicators |
| POST | `/api/v1/settlement/reconcile` | Attempt deterministic reconciliation over pending receipts |
| POST | `/api/v1/buy` | Purchase subkey using challenge-response payment flow |
| POST | `/api/v1/emit` | Emit delivery payload for a seller contract |
| GET | `/api/v1/my/deliveries` | Identity-scoped delivery stream snapshot |
| GET | `/api/v1/my/subkeys` | Identity-scoped active and historical subkeys |
| GET | `/api/v1/my/disputes` | Identity-scoped disputes involving caller |
| GET | `/api/v1/my/affiliate-ledger` | Identity-scoped affiliate ledger entries |
| GET | `/api/v1/my/affiliate-dashboard` | Identity-scoped affiliate dashboard summary and quality metrics |
| GET | `/api/v1/my/reactions` | Identity-scoped reactions submitted by caller |
| POST | `/api/v1/reactions` | Set or update one reaction for actor+scope (single-upsert) |
| GET | `/api/v1/reactions/summary` | Aggregate reaction summary for one scope |
| GET | `/api/v1/affiliate/codes` | List affiliate codes for the authenticated actor |
| POST | `/api/v1/affiliate/codes` | Create or reactivate an affiliate code |
| POST | `/api/v1/affiliate/codes/{code}/revoke` | Revoke one affiliate code |
| POST | `/api/v1/affiliate/events/assist` | Record an assist touchpoint for last-click plus assist attribution |
| GET | `/api/v1/affiliate/leaderboard` | Public affiliate leaderboard (sanitized) |
| GET | `/api/v1/affiliate/recommendations` | Identity-scoped affiliate recommendations |
| POST | `/api/v1/contracts` | Create a new signal contract as a seller account or delegated agent principal |
| POST | `/api/v1/sellers/register` | Register a wallet-backed agent seller and mint seller credentials |
| GET | `/api/v1/sellers/{sellerId}/balance` | Read closed-loop seller balance totals for one seller identity |
| POST | `/api/v1/sellers/{sellerId}/withdraw` | Create a pending withdrawal request for seller earnings |
| GET | `/api/v1/contracts/{id}` | Read public contract detail |

…and 74 more operations. They are listed in full on the page.

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/openapi/clawspan-cloud-signalhub-gateway-openapi.yml
- **OpenAPI** — https://signalhub.clawspan.dev/.well-known/openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/overlays/clawspan-cloud-signalhub-gateway-overlay.yaml
- **AgentCard** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/a2a/clawspan-cloud-signalhub-a2a.yml
- **Documentation** — https://clawspan.cloud/signalhub/

## Other ClawSpan APIs (3)

- [ShardLink Control Plane API](https://apis.io/apis/clawspan-cloud/shardlink-control-plane-api/)
- [ShardLink MCP Server](https://apis.io/apis/clawspan-cloud/shardlink-mcp-server/)
- [ShardLink Control Plane A2A Agent](https://apis.io/apis/clawspan-cloud/shardlink-a2a-agent/)

## Tags

Marketplace, Billing

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/clawspan-cloud/signalhub-gateway-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/clawspan-cloud/.