Observatory

The Observatory is SohoPay’s public status and health dashboard: no login, no API key. Use it to answer “is it me or is it SohoPay?” before you open a debugger, and to feed your own monitoring via the /health and /status endpoints.

System health

Metric	What it shows	How to interpret it
Policy Service uptime	Current uptime %, with a 30-day chart	The number that matters most: settlement is fail-closed, so if this is down, nothing settles — see SLA
Settlement finality	Average, P95, and P99 time from payment submission to on-chain finality	Baseline is ~1s on Base. Watch P99, not the average — a healthy average with a climbing P99 means a slice of your payments is slow
API availability	Green/red per API surface	Red here with green Policy Service means reads/writes fail but nothing is stuck mid-settlement
Webhook delivery success	% of webhook deliveries accepted on first attempt	A dip here that only you see usually means your endpoint is failing — check your receiver before filing a ticket. See Webhooks

Live network activity

Metric	Interpretation
Active agents	Network-wide count of agents that transacted recently — a liveness signal for the network as a whole
Payments processed (24h)	Rolling 24-hour payment count
Settlement volume (24h)	Rolling 24-hour USDC volume
Average latency (ms)	End-to-end API latency; compare your observed latency against it to separate network issues from SohoPay issues
Error rate (%)	Share of API requests returning 5xx. 4xx errors (your bugs: bad keys, expired orders) are not counted — so a zero here doesn’t mean your integration is healthy

Debugging heuristic: if the Observatory is green and your integration is failing, the problem is almost certainly on your side — start with Troubleshooting and the Live Feed. If the Observatory shows an incident, subscribe to updates and wait rather than shipping a “fix”.

Alerts

The Observatory’s alerts panel carries three kinds of notices:

Current incidents — open incidents with severity, impact, and timestamped updates until resolution.
Scheduled maintenance — the Sunday 02:00–02:30 UTC window and any exceptional maintenance, announced 1 week ahead per the SLA.
Deprecations — API versions or fields scheduled for removal, with sunset dates. Check this before pinning SDK versions long-term.

API access: /health and /status

Both endpoints are unauthenticated and safe to wire into your own uptime monitors. GET /health — coarse API liveness:

curl https://api.sohopay.xyz/v1/health

Response

{
  "status": "ok",
  "api": "available",
  "time": "2026-08-22T10:15:00Z"
}

GET /status — component-level detail, matching what the Observatory renders:

curl https://api.sohopay.xyz/v1/status

Response

{
  "policy_service": { "status": "operational", "uptime_30d": "99.97" },
  "settlement": {
    "status": "operational",
    "finality_avg_ms": 1080,
    "finality_p95_ms": 1650,
    "finality_p99_ms": 2900
  },
  "webhooks": { "status": "operational", "delivery_success_rate": "99.4" },
  "active_incidents": [],
  "scheduled_maintenance": [
    { "window": "2026-08-30T02:00:00Z/2026-08-30T02:30:00Z", "impact": "settlement_queuing" }
  ]
}

Sandbox equivalents live at https://api-sandbox.sohopay.xyz/v1/health and /status.

Poll at 5–10 second intervals, no faster. These endpoints are unauthenticated but not unmetered — aggressive polling from one IP gets rate-limited like any other traffic. For settlement state of your payments, use webhooks instead of polling /status.

Next steps

Live Feed

Drop from network-level health to individual transactions.

SLA & Disaster Recovery

What the uptime target commits to and what happens during outages.

Troubleshooting

What to check when the Observatory is green but your calls fail.

Getting Started

Merchant Integration

Agent Wallet Setup

Payment Flow

Protocol & Standards

Compliance & Risk

Operational Dashboards

System health

Live network activity

Alerts

API access: /health and /status

Next steps

Live Feed

SLA & Disaster Recovery

Troubleshooting

​System health

​Live network activity

​Alerts

​API access: /health and /status

​Next steps

Live Feed

SLA & Disaster Recovery

Troubleshooting

System health

Live network activity

Alerts

API access: /health and /status

Next steps