# Hermes Counterparty Availability API

> Hermes Counterparty Availability API is a paid API for AI agents from hermes-counterparty-api.onrender.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns business-day and contact-window status for a given country, indicating whether counterparties are reachable right now based on local time, public holidays, and business hours.

## Facts

- Endpoint: POST https://hermes-counterparty-api.onrender.com/v1/counterparty-availability
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-counterparty-availability-api-3a0fd3ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w3kMGo2VWc4637Wy5qCdn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hermes-counterparty-availability-api-3a0fd3ac -d '<json body>'
```

Example prompt: Is today a business day in Germany, and if not, when's the next time I can reach someone there during business hours? Use the Europe/Berlin timezone.

## When to prefer this

Choose this endpoint when you need a deterministic, structured answer about whether a business counterparty in a specific country is reachable right now — accounting for weekends, public holidays, and local business hours. It is especially useful for agents automating cross-border scheduling, payment timing, or communication routing where getting the business-day status wrong has real consequences. Prefer it over generic timezone converters when you need the full business-context picture (holiday name, contact window, next business date) in one call.

## Known failure modes

- Unsupported country code — only 12 country codes accepted; passing an unlisted ISO code will likely return a validation error
- Invalid IANA timezone string — malformed or unrecognized timezone values may cause a 400 error or fallback to country default
- Payment failure — missing or insufficient x402 USDC payment header will result in a 402 Payment Required response
- Service unavailability — hosted on Render free tier, cold starts or downtime may cause timeouts or 503 errors
- Stale holiday data — public holiday schedules may not be updated for newly announced or regional holidays

## How this service works

Agent utilities for company research, package maintenance intelligence, dependency vulnerability checks, counterparty availability, SEC company snapshots, OFAC sanctions screening, and deterministic JSON/CSV data-quality work. Company domain intelligence includes a free preview before the paid enrichment call.

## Output

A JSON object containing: local datetime details (ISO timestamp, date, time, weekday), country metadata (name, currency, calling code, holiday scope), and a business context block covering whether today is a business day, whether it is a weekend or public holiday, the name of any holiday, the current contact window status, the next business date, the next contactable local datetime, assumed business hours, and business days remaining in the current week. Also includes the resolved timezone and its source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "timezone": {
   "type": "string",
   "description": "Optional IANA timezone; defaults to the country's primary business timezone"
  },
  "country_code": {
   "enum": [
    "US",
    "CA",
    "MX",
    "GB",
    "DE",
    "FR",
    "ES",
    "IT",
    "BR",
    "JP",
    "IN",
    "AU"
   ],
   "type": "string",
   "description": "ISO 3166-1 alpha-2 country code"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "local": {
   "iso": "2026-08-20T08:00",
   "date": "2026-08-20",
   "time": "08:00",
   "weekday": "Thu"
  },
  "country": {
   "code": "US",
   "name": "United States",
   "currency": "USD",
   "calling_code": "+1",
   "holiday_scope": "US federal"
  },
  "business": {
   "is_weekend": false,
   "holiday_name": null,
   "contact_window": "closed",
   "is_business_day": true,
   "is_public_holiday": false,
   "next_business_date": "2026-08-20",
   "next_contact_local": "2026-08-20T09:00",
   "assumed_business_hours": "09:00-17:00 local",
   "business_days_remaining_this_week": 2
  },
  "timezone": "America/Chicago",
  "timezone_source": "request"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-counterparty-availability-api-3a0fd3ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hermes-counterparty-api.onrender.com](https://www.zero.xyz/host/hermes-counterparty-api.onrender.com/llms.txt)