Roundhouse

Netzhandwerker Agent Tools

Builds the cohort table from the events you pass: users grouped by the period of their first event, counted again in each following period. Returns the table per cohort, a retention curve across all cohorts, and, where events carry a value, cumulative value and value per user. The curve counts only cohorts old enough for a given period, so a young cohort is not scored as churn. Day, week and month are real calendar periods. Nothing is fetched, nothing is stored.

DataLiveeip155:8453Exactvia cdp
https://tools.halowerk.com/v1/cohort/retention
x402Agent-toolsAnalysisCohort_retention
Calls · 30d
1→ 0%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 26 snapshots so far.
$11.47
Verified settled volume
2,654 settlements proven x402 by their on-chain EIP-3009 marker.
$0.0020
Listed price
As published in the catalog. Always read the live 402 before paying.
1
Calls · 30d
Upstream's own call count for this endpoint, not ours.
1
Unique payers · 30d
Last called 2026-08-19 15:03Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E

The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.

Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Provider

The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "docs": "https://tools.halowerk.com/examples",
  "tool": {
    "id": "cohort_retention",
    "summary": "Cohort table, retention curve and value per user",
    "price_usdc": "0.002",
    "input_schema": {
      "type": "object",
      "required": [
        "events"
      ],
      "properties": {
        "events": {
          "type": "array",
          "maxItems": 4000,
          "minItems": 1,
          "description": "Each event needs user_id and a timestamp (time_unix_s in seconds since 1970, or time as ISO 8601). Optional: type and value. Any other field name is rejected rather than guessed. The service caps the whole request body at 256 KB, so long records reach that limit before maxItems."
        },
        "period": {
          "enum": [
            "day",
            "week",
            "month"
          ],
          "type": "string",
          "default": "week"
        },
        "periods": {
          "type": "integer",
          "default": 12,
          "maximum": 52,
          "minimum": 1,
          "description": "How many periods the table runs, period 0 being the entry period."
        },
        "week_start": {
          "enum": [
            "monday",
            "sunday"
          ],
          "type": "string",
          "default": "monday"
        },
        "activation_type": {
          "type": "string",
          "maxLength": 120,
          "description": "If set, only events of this type put a user into a cohort. Without it the first event of any type counts."
        },
        "retention_types": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 50,
          "description": "If set, only events of these types count as being active. Without it every event counts."
        },
        "timezone_offset_s": {
          "type": "integer",
          "default": 0,
          "maximum": 50400,
          "minimum": -50400,
          "description": "Offset from UTC in seconds used to place period boundaries."
        }
      }
    }
  },
  "error": "payment_required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "asset": "USDC",
        "version": "2",
        "decimals": 6,
        "eip712Domain": {
          "name": "USD Coin",
          "chainId": 8453,
          "version": "2",
          "verifyingContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        },
        "network_name": "Base Mainnet",
        "assetTransferMethod": "eip3009"
      },
      "payTo": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E",
      "amount": "2000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 300
    }
  ],
  "resource": {
    "url": "https://tools.halowerk.com/v1/cohort/retention",
    "tags": [
      "x402",
      "agent-tools",
      "analysis",
      "cohort_retention"
    ],
    "mimeType": "application/json",
    "description": "Builds the cohort table from the events you pass: users grouped by the period of their first event, counted again in each following period. Returns the table per cohort, a retention curve across all cohorts, and, where events carry a value, cumulative value and value per user. The curve counts only cohorts old enough for a given period, so a young cohort is not scored as churn. Day, week and month are real calendar periods. Nothing is fetched, nothing is stored.",
    "inputSchema": {
      "type": "object",
      "required": [
        "events"
      ],
      "properties": {
        "events": {
          "type": "array",
          "maxItems": 4000,
          "minItems": 1,
          "description": "Each event needs user_id and a timestamp (time_unix_s in seconds since 1970, or time as ISO 8601). Optional: type and value. Any other field name is rejected rather than guessed. The service caps the whole request body at 256 KB, so long records reach that limit before maxItems."
        },
        "period": {
          "enum": [
            "day",
            "week",
            "month"
          ],
          "type": "string",
          "default": "week"
        },
        "periods": {
          "type": "integer",
          "default": 12,
          "maximum": 52,
          "minimum": 1,
          "description": "How many periods the table runs, period 0 being the entry period."
        },
        "week_start": {
          "enum": [
            "monday",
            "sunday"
          ],
          "type": "string",
          "default": "monday"
        },
        "activation_type": {
          "type": "string",
          "maxLength": 120,
          "description": "If set, only events of this type put a user into a cohort. Without it the first event of any type counts."
        },
        "retention_types": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 50,
          "description": "If set, only events of these types count as being active. Without it every event counts."
        },
        "timezone_offset_s": {
          "type": "integer",
          "default": 0,
          "maximum": 50400,
          "minimum": -50400,
          "description": "Offset from UTC in seconds used to place period boundaries."
        }
      }
    },
    "serviceName": "HALOWERK Agent Tools"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "events": [
              {
                "type": "order",
                "value": 19.9,
                "user_id": "u1",
                "time_unix_s": 1785110400
              },
              {
                "type": "order",
                "value": 24.5,
                "user_id": "u1",
                "time_unix_s": 1785715200
              },
              {
                "type": "order",
                "value": 12,
                "user_id": "u2",
                "time_unix_s": 1785110400
              },
              {
                "type": "order",
                "value": 30,
                "user_id": "u3",
                "time_unix_s": 1785715200
              }
            ],
            "period": "week",
            "periods": 3
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "output": {
          "type": "json"
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "body": {
                "type": "object",
                "required": [
                  "events"
                ],
                "properties": {
                  "events": {
                    "type": "array",
                    "maxItems": 4000,
                    "minItems": 1,
                    "description": "Each event needs user_id and a timestamp (time_unix_s in seconds since 1970, or time as ISO 8601). Optional: type and value. Any other field name is rejected rather than guessed. The service caps the whole request body at 256 KB, so long records reach that limit before maxItems."
                  },
                  "period": {
                    "enum": [
                      "day",
                      "week",
                      "month"
                    ],
                    "type": "string",
                    "default": "week"
                  },
                  "periods": {
                    "type": "integer",
                    "default": 12,
                    "maximum": 52,
                    "minimum": 1,
                    "description": "How many periods the table runs, period 0 being the entry period."
                  },
                  "week_start": {
                    "enum": [
                      "monday",
                      "sunday"
                    ],
                    "type": "string",
                    "default": "monday"
                  },
                  "activation_type": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "If set, only events of this type put a user into a cohort. Without it the first event of any type counts."
                  },
                  "retention_types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 50,
                    "description": "If set, only events of these types count as being active. Without it every event counts."
                  },
                  "timezone_offset_s": {
                    "type": "integer",
                    "default": 0,
                    "maximum": 50400,
                    "minimum": -50400,
                    "description": "Offset from UTC in seconds used to place period boundaries."
                  }
                }
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json"
                ],
                "type": "string"
              }
            }
          }
        }
      }
    }
  },
  "x402Version": 2,
  "capability_request": {
    "url": "https://bedarf.halowerk.com/capabilities/request",
    "cost": "free",
    "method": "POST",
    "description": "Missing a capability, or does the scope not fit? Report the need here - no payment required. Similar reports are bundled; the response returns an id you can check back on.",
    "body_example": {
      "max_price": 0.01,
      "description": "what exactly is needed",
      "requested_capability": "short label"
    }
  }
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

0.002USDC≈ $0.002 USD
on Base · exact scheme

Pay 0.002 USDC on Base to 0x2880…C4E5E. The signed payment is good for 5 minutes.

Paid to
0x2880…C4E5E
USD Coin contract
0x8335…02913
Payment window
5 minutes
As published
2000 smallest units
The catalog’s raw entry
[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "asset": "USDC",
      "version": "2",
      "decimals": 6,
      "eip712Domain": {
        "name": "USD Coin",
        "chainId": 8453,
        "version": "2",
        "verifyingContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      },
      "network_name": "Base Mainnet",
      "assetTransferMethod": "eip3009"
    },
    "payTo": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E",
    "amount": "2000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "events": [
            {
              "type": "order",
              "value": 19.9,
              "user_id": "u1",
              "time_unix_s": 1785110400
            },
            {
              "type": "order",
              "value": 24.5,
              "user_id": "u1",
              "time_unix_s": 1785715200
            },
            {
              "type": "order",
              "value": 12,
              "user_id": "u2",
              "time_unix_s": 1785110400
            },
            {
              "type": "order",
              "value": 30,
              "user_id": "u3",
              "time_unix_s": 1785715200
            }
          ],
          "period": "week",
          "periods": 3
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      },
      "output": {
        "type": "json",
        "example": {
          "curve": [
            {
              "active_users": 3,
              "period_index": 0,
              "users_at_risk": 3,
              "retention_rate": 1,
              "cohorts_observed": 2
            },
            {
              "active_users": 1,
              "period_index": 1,
              "users_at_risk": 2,
              "retention_rate": 0.5,
              "cohorts_observed": 1
            }
          ],
          "period": "week",
          "cohorts": [
            {
              "users": 2,
              "cohort": "2026-07-27T00:00:00.000Z",
              "periods": [
                {
                  "active_users": 2,
                  "period_index": 0,
                  "period_value": 31.9,
                  "retention_rate": 1,
                  "cumulative_value": 31.9,
                  "cumulative_value_per_user": 15.95
                },
                {
                  "active_users": 1,
                  "period_index": 1,
                  "period_value": 24.5,
                  "retention_rate": 0.5,
                  "cumulative_value": 56.4,
                  "cumulative_value_per_user": 28.2
                },
                {
                  "active_users": 0,
                  "period_index": 2,
                  "period_value": 0,
                  "retention_rate": 0,
                  "cumulative_value": 56.4,
                  "cumulative_value_per_user": 28.2
                }
              ],
              "cohort_start_unix_s": 1785110400
            }
          ],
          "periods": 3,
          "summary": {
            "total_value": 86.4,
            "value_per_user": 28.8,
            "last_event_unix_s": 1785715200,
            "first_event_unix_s": 1785110400,
            "median_lifetime_periods": 1
          },
          "stateless": true,
          "user_count": 3,
          "week_start": "monday",
          "event_count": 4,
          "cohort_count": 2,
          "activation_type": null,
          "retention_types": null,
          "timezone_offset_s": 0
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "properties": {
            "body": {
              "type": "object",
              "required": [
                "events"
              ],
              "properties": {
                "events": {
                  "type": "array",
                  "maxItems": 4000,
                  "minItems": 1,
                  "description": "Each event needs user_id and a timestamp (time_unix_s in seconds since 1970, or time as ISO 8601). Optional: type and value. Any other field name is rejected rather than guessed. The service caps the whole request body at 256 KB, so long records reach that limit before maxItems."
                },
                "period": {
                  "enum": [
                    "day",
                    "week",
                    "month"
                  ],
                  "type": "string",
                  "default": "week"
                },
                "periods": {
                  "type": "integer",
                  "default": 12,
                  "maximum": 52,
                  "minimum": 1,
                  "description": "How many periods the table runs, period 0 being the entry period."
                },
                "week_start": {
                  "enum": [
                    "monday",
                    "sunday"
                  ],
                  "type": "string",
                  "default": "monday"
                },
                "activation_type": {
                  "type": "string",
                  "maxLength": 120,
                  "description": "If set, only events of this type put a user into a cohort. Without it the first event of any type counts."
                },
                "retention_types": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "maxItems": 50,
                  "description": "If set, only events of these types count as being active. Without it every event counts."
                },
                "timezone_offset_s": {
                  "type": "integer",
                  "default": 0,
                  "maximum": 50400,
                  "minimum": -50400,
                  "description": "Offset from UTC in seconds used to place period boundaries."
                }
              }
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog
2026-08-19 15:03Z
Last indexed by Roundhouse
2026-09-18 15:01Z
Last enriched (probe, favicon, geo)
2026-09-23 09:45Z
x402 version
2
Max timeout
300s
Liveness probe
HTTP 402
Report

Hand this page to an agent

Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.

GET api.roundhouseai.io/v0/endpoints

This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 26 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.

Open skill.md
Show the prompt
Using Roundhouse, look up the x402 service Netzhandwerker Agent Tools and tell me whether it is
worth paying: what a call costs, whether the endpoint answered when last probed, and what
its payment record actually shows.

curl -s 'https://api.roundhouseai.io/v0/endpoints?q=Netzhandwerker%20Agent%20Tools'
curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>'

Then call it: read the price from the live 402 at https://tools.halowerk.com/v1/cohort/retention, never from
a cached figure, and pay with an x402 client.

The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except
/v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402,
or use an organization key from https://roundhouseai.io/dashboard/team.

If you do not have Roundhouse tools or skills installed, read
https://roundhouseai.io/skill.md first — it is the whole procedure.