ToolAssay

Fetches kind 3 contact lists over up to twelve relays

Fetches kind 3 contact lists over up to twelve relays. Because kind 3 is replaceable, several relays regularly hold different versions; only the one with the highest created_at is used and the answer states which relays carried that version and how many older versions were seen, so a stale relay never quietly overwrites a current list. At depth 1 the answer is the account and its outgoing follows.

Answeringour last check, 2026-10-10
1 of 1checks answered this week
901 msmedian answer time
$0.004listed price per call
$0.004price it asked us

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://nostr.halowerk.com/follower-graph

CategoryEverything else
Provider hostnostr.halowerk.com
Networkseip155:8453
Payment schemesexact
Self-reported calls, 30 days2 from 1 payers (the provider's figure, not ours)

Our checks, last 30 days

DayResultHTTPAskedTime
2026-10-10 valid payment request 402$0.004 901 ms

Example input (from the provider)

{
  "body": {
    "pubkey": "beispiel"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "depth": {
              "default": 1,
              "description": "1 returns the account and its follows. 2 also fetches the contact lists of its contacts.",
              "enum": [
                1,
                2
              ],
              "type": "integer"
            },
            "max_contacts": {
              "default": 200,
              "description": "Upper bound on contacts reported for the root account.",
              "maximum": 500,
              "minimum": 1,
              "type": "integer"
            },
            "pubkey": {
              "description": "Public key as 64 hex characters, npub or nprofile.",
              "type": "string"
            },
            "relays": {
              "description": "wss relay addresses. Left empty, ten measured default relays are used.",
              "items": {
                "type": "string"
              },
              "maxItems": 12,
              "type": "array"
            },
            "second_degree_sample": {
              "default": 15,
              "description": "How many contact lists to fetch at depth 2. Higher values cost time, not money.",
              "maximum": 25,
              "minimum": 1,
              "type": "integer"
            }
          },
          "required": [
            "pubkey"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON