# magent Hamilton Depression Rating Scale (1960, 17-item)

> magent Hamilton Depression Rating Scale (1960, 17-item) is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Computes the Hamilton 1960 17-variable depression total score (0–50) from caller-assigned item ratings without interviewing the patient.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/hamilton_depression
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-hamilton-depression-rating-scale-1960-17-item-5b7a8b0b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ImnBseYW0dL9xCKRr44zS

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 magent-hamilton-depression-rating-scale-1960-17-item-5b7a8b0b
```

Example prompt: Calculate the 1960 Hamilton Depression Rating Scale total score for a patient whose clinician-assigned item values are: depressed mood 3, guilt 2, suicide 1, initial insomnia 1, middle insomnia 2, delayed insomnia 1, work and interests 3, retardation 2, agitation 1, psychic anxiety 2, somatic anxiety 2, GI somatic 1, general somatic 1, genital symptoms 1, hypochondriasis 2, insight 1, weight loss 1.

## When to prefer this

Choose this endpoint when you need to compute the original Hamilton 1960 17-variable depression total score (range 0–50) precisely, including agitation as a 3-point item rather than the later 21-item revision. Prefer this over the 21-item HAM-D or other depression scales when the 1960 protocol is specified by a study, clinician workflow, or legacy system. It is a pure arithmetic summation service — fast, deterministic, and reproducible for structured clinical data pipelines.

## Known failure modes

- Missing any of the 17 required query parameters returns a validation error
- Integer values out of range for a given item (e.g. agitation >2 or guilt >4) are rejected
- Non-integer values for item scores cause a schema validation failure
- Payment of 0.005 USDC via x402 required per call; missing or invalid payment returns a 402 error

## How this service works

Hamilton 1960 17-variable depression rating (not the later 21-item form). Eight caller-assigned 0-4 items and nine 0-2 items (agitation is three-point in that paper). Sum 0-50. magent does not interview. Hamilton 1960 printed no total-score severity bands; later 0-7/8-16/17-23/>=24 cutoffs are not applied. Not a diagnosis and not a medical device.

## Output

Returns the total Hamilton Depression Rating Scale (1960, 17-item) score as an integer between 0 and 50, computed by summing all 17 caller-assigned item ratings. No severity band labels are applied, no diagnosis is made, and the endpoint does not conduct patient interviews.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "depressed_mood",
      "guilt",
      "suicide",
      "insomnia_initial",
      "insomnia_middle",
      "insomnia_delayed",
      "work_and_interests",
      "retardation",
      "agitation",
      "anxiety_psychic",
      "anxiety_somatic",
      "somatic_gastrointestinal",
      "somatic_general",
      "genital_symptoms",
      "hypochondriasis",
      "insight",
      "loss_of_weight"
     ],
     "properties": {
      "guilt": {
       "type": "integer",
       "description": "Caller-assigned Hamilton 1960 guilt (integer 0-4): self-reproach, ideas of guilt, present illness as punishment, delusions or hallucinations of guilt. magent does not interview the patient."
      },
      "insight": {
       "type": "integer",
       "description": "Caller-assigned Hamilton 1960 insight (integer 0-2: 0 no loss, 1 partial or doubtful loss, 2 loss of insight), interpreted in terms of the patient's understanding and background. magent does not interview the patient."
      },
      "suicide": {
       "type": "integer",
       "description": "Caller-assigned Hamilton 1960 suicide (integer 0-4): feels life is not worth living, wishes to be dead, suicidal ideas; an attempt at suicide scores 4 (3 if sudden against little suicidal tendency). magent does not interview the patient."
      },
      "agitation": {
       "type": "integer",
       "description": "Caller-assigned Hamilton 1960 agitation (integer 0-2 three-point; a five-point scale was impracticable in that paper): restlessness associated with anxiety. magent does not interview the patient."
      },
      "retardation": {
       "type": "integer",
       "description": "Caller-assigned Hamilton 1960 retardation (integer 0-4): slowness of thought, speech, and activity, apathy, stupor (1 slight at interview, 2 obvious, 3 interview difficult, 4 complete stupor). magent does not interview the patient."
      },
      "depressed_mood": {
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-hamilton-depression-rating-scale-1960-17-item-5b7a8b0b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)