{"uid":"cap_ImnBseYW0dL9xCKRr44zS","slug":"magent-hamilton-depression-rating-scale-1960-17-item-5b7a8b0b","name":"magent Hamilton Depression Rating Scale (1960, 17-item)","description":"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.","url":"https://api.magentlab.com/api/calc/hamilton_depression","method":"GET","headers":{},"bodySchema":{"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":{"type":"integer","description":"Caller-assigned Hamilton 1960 depressed mood (integer 0-4: 0 absent, 1 mild or trivial, 2 moderate, 3 severe, 4 extreme): gloomy attitude, pessimism about the future, feeling of sadness, tendency to weep. magent does not interview the patient."},"loss_of_weight":{"type":"integer","description":"Caller-assigned Hamilton 1960 loss of weight (integer 0-2 three-point scale as published, because few patients know their normal weight). magent does not weigh the patient."},"anxiety_psychic":{"type":"integer","description":"Caller-assigned Hamilton 1960 anxiety, psychic (integer 0-4): tension and irritability, worrying about minor matters, apprehensive attitude, fears. magent does not interview the patient."},"anxiety_somatic":{"type":"integer","description":"Caller-assigned Hamilton 1960 anxiety, somatic (integer 0-4): gastrointestinal (wind, indigestion), cardiovascular (palpitations, headaches), respiratory, genito-urinary, and other somatic anxiety. magent does not interview the patient."},"hypochondriasis":{"type":"integer","description":"Caller-assigned Hamilton 1960 hypochondriasis (integer 0-4): self-absorption (bodily), preoccupation with health, querulous attitude, hypochondriacal delusions. magent does not interview the patient."},"insomnia_middle":{"type":"integer","description":"Caller-assigned Hamilton 1960 insomnia, middle (integer 0-2): restless and disturbed during the night, waking during the night. magent does not interview the patient."},"somatic_general":{"type":"integer","description":"Caller-assigned Hamilton 1960 somatic symptoms, general (integer 0-2): heaviness in limbs, back, or head; diffuse backache; loss of energy and fatiguability. magent does not interview the patient."},"genital_symptoms":{"type":"integer","description":"Caller-assigned Hamilton 1960 genital symptoms (integer 0-2): loss of libido, menstrual disturbances. magent does not interview the patient."},"insomnia_delayed":{"type":"integer","description":"Caller-assigned Hamilton 1960 insomnia, delayed (integer 0-2): waking in the early hours of the morning and unable to fall asleep again. magent does not interview the patient."},"insomnia_initial":{"type":"integer","description":"Caller-assigned Hamilton 1960 insomnia, initial (integer 0-2: 0 absent, 1 slight or doubtful, 2 clearly present): difficulty in falling asleep. magent does not interview the patient."},"work_and_interests":{"type":"integer","description":"Caller-assigned Hamilton 1960 work and interests (integer 0-4): feelings of incapacity, listlessness, loss of interest in hobbies, decreased social activities or productivity; given up work solely because of present illness is 4. magent does not interview the patient."},"somatic_gastrointestinal":{"type":"integer","description":"Caller-assigned Hamilton 1960 somatic symptoms, gastrointestinal (integer 0-2): loss of appetite, heavy feelings in abdomen, constipation. magent does not interview the patient."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hXYyFhbY9zS7Q-zRbvqs1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Hamilton 1960 17-variable depression total score (0–50) from caller-assigned item ratings without interviewing the patient.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Psychiatric intake scoring workflow","prompt":"I just finished rating a patient on the 17 Hamilton depression items from the 1960 paper — depressed mood 2, guilt 1, suicide 0, initial insomnia 1, middle insomnia 1, delayed insomnia 0, work and interests 2, retardation 1, agitation 0, psychic anxiety 2, somatic anxiety 1, GI somatic 1, general somatic 1, genital symptoms 0, hypochondriasis 1, insight 0, weight loss 1 — can you calculate the total HAMD score for me?"},{"title":"Clinical trial baseline depression score","prompt":"For a research participant entering a depression trial, we need the Hamilton 1960 total score. Their ratings are: depressed mood 4, guilt 3, suicide 2, initial insomnia 2, middle insomnia 2, delayed insomnia 2, work and interests 4, retardation 3, agitation 2, psychic anxiety 3, somatic anxiety 3, GI somatic 2, general somatic 2, genital symptoms 2, hypochondriasis 3, insight 1, weight loss 2 — what's the total out of 50?"},{"title":"Treatment response monitoring score","prompt":"My patient's follow-up Hamilton depression item ratings are: depressed mood 1, guilt 0, suicide 0, initial insomnia 1, middle insomnia 0, delayed insomnia 0, work and interests 1, retardation 0, agitation 0, psychic anxiety 1, somatic anxiety 1, GI somatic 0, general somatic 1, genital symptoms 0, hypochondriasis 1, insight 0, weight loss 0 — please calculate their current HDRS-17 total so I can compare to their baseline."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:10:08.205Z","isFirstParty":false}