# Suverse Tor Relay Details

> Suverse Tor Relay Details is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Fetches Tor relay and bridge records from the Tor Project's Onionoo service, returning details like nickname, fingerprint, flags, bandwidth, IP addresses, AS, country, and first-seen date, searchable by fingerprint, nickname, IP, or country.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-tor-relay-details
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-tor-relay-details-6f2c97e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Udq5-VFnfq6-5LPnje3nf

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 suverse-tor-relay-details-6f2c97e8 -d '<json body>'
```

Example prompt: Look up the Tor relay with fingerprint A1B2C3D4E5F6... and tell me its nickname, flags, bandwidth, country, and when it first appeared on the network.

## When to prefer this

Use this endpoint when you need programmatic, paid-API access to Tor relay and bridge metadata from the Onionoo dataset without managing your own Onionoo integration. Ideal for cybersecurity tools that need to flag Tor exit nodes, network analysts researching relay geography, or threat intelligence pipelines enriching IP data with Tor presence information.

## Known failure modes

- No matching relay found for the given search criteria — returns empty result set
- Invalid or malformed fingerprint format — may return an error or empty results
- Country code not recognized — query returns no results
- Network timeout reaching the upstream Onionoo service
- Rate limiting or payment failure for the x402 paywall

## How this service works

Tor relay and bridge records from the Tor Project's Onionoo service: nickname, fingerprint, flags, bandwidth, IPs, AS, country and first-seen. Search by fingerprint, nickname, IP or country. Keyless.

## Output

Returns structured records for matching Tor relays or bridges, including: relay nickname, fingerprint, operational flags (e.g. Exit, Guard, Fast), measured bandwidth, IP addresses, autonomous system (AS) number and name, country code, and the date the relay was first observed on the Tor network.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-tor-relay-details-6f2c97e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)