{"uid":"cap_ubF1EfvuThNgshY41ret7","slug":"music-theory-key-signature-lookup-38ebacc0","name":"Music Theory Key Signature Lookup","description":"Key signature (sharps or flats), circle-of-fifths neighbours, relative and parallel keys for any major or minor key.","url":"https://music-theory.x402tookit.com/key-signature?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["key"],"properties":{"key":{"type":"string","description":"Key: C, G, Bb, F# minor, Am, Ebm"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"key":{"type":["null","string"]},"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"signature":{"type":["null","object"],"properties":{"type":{"type":["null","string"]},"count":{"type":["null","number"]},"accidentals":{"type":["array","null"],"items":{"type":"string"}},"theoretical":{"type":["boolean","null"]}}},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"scaleNotes":{"type":["array","null"],"items":{"type":"string"}},"dominantKey":{"type":["null","string"]},"parallelKey":{"type":["null","string"]},"relativeKey":{"type":["null","string"]},"enharmonicKey":{},"circleOfFifths":{"type":["array","null"],"items":{"type":"object","properties":{"clock":{"type":["null","number"]},"major":{"type":["null","string"]},"minor":{"type":["null","string"]},"accidentals":{"type":["null","string"]}}}},"fifthsPosition":{"type":["null","number"]},"subdominantKey":{"type":["null","string"]},"parallelSignature":{"type":["null","object"],"properties":{"type":{"type":["null","string"]},"count":{"type":["null","number"]},"accidentals":{"type":["array","null"],"items":{"type":"string"}},"theoretical":{"type":["boolean","null"]}}},"circleOfFifthsClockPosition":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nqVMx5-DRCGqHQe9td9HN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns key signature details (sharps/flats, accidentals), circle-of-fifths position and neighbours, and relative/parallel keys for any major or minor key.","exampleAgentPrompt":"What's the key signature for F# minor — how many sharps or flats does it have, what are the accidentals, and what are its relative and parallel keys?","exampleUseCases":[{"title":"Composing in a new key","prompt":"I'm writing a piece in Bb major — can you tell me its key signature, which accidentals it uses, and what its relative minor and circle-of-fifths neighbours are?"},{"title":"Music theory homework help","prompt":"For my theory class I need to know everything about the key of D minor: how many flats it has, its relative major, parallel major, dominant and subdominant keys, and where it sits on the circle of fifths."},{"title":"Transposing song to a related key","prompt":"I'm thinking of moving a song from E major to a nearby key — can you show me E major's circle-of-fifths neighbours, its relative minor, and its key signature so I can decide where to go?"}],"resultDescription":"A JSON object containing: the key signature type (sharp or flat), count of accidentals, list of accidental note names, whether it is a theoretical key, all scale notes, the relative key, parallel key, dominant key, subdominant key, enharmonic equivalent key, the key's position on the circle of fifths (clock position and fifths index), and the full circle-of-fifths array with clock positions and accidental counts for each key.","failureModes":["Missing 'key' query parameter returns an error","Unrecognized key name or format returns null/error fields","Ambiguous key names without major/minor qualifier may default to major","Theoretical keys (e.g. G# major) may be flagged with a 'theoretical' flag rather than rejected"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured key signature data for any standard or theoretical major/minor key, including accidentals, circle-of-fifths relationships, and relative/parallel key lookups — especially when building music theory tools, educational apps, or composition assistants that need reliable harmonic context rather than generating that information from an LLM.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-03T12:30:47.646Z","isFirstParty":false,"canonicalSlug":"music-theory-key-signature-lookup-38ebacc0"}