Time-signature math API

Analyses a time signature — simple vs compound classification, felt beats per bar, bar value in whole notes, and (given BPM) the note, bar and total-passage durations in ms. Answers 'Is 6/8 simple or compound?', 'How long is a bar of 4/4 at 120 BPM?'.

Price$0.04per request

MethodPOST

Route/v1/music/time-signature

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

musictime-signaturemetercompoundbardurationrhythmtheoryaudio

API URLhttps://x402.hexl.dev/v1/music/time-signature

Integration docs

Example request

{
  "numerator": 6,
  "denominator": 8,
  "bpm": 120
}

Example response

{
  "timeSignature": "6/8",
  "numerator": 6,
  "denominator": 8,
  "classification": "compound",
  "beatUnit": "1/8 note",
  "notesPerBar": 6,
  "feltBeatsPerBar": 2,
  "barValueInWholeNotes": 0.75,
  "bpm": 120,
  "noteDurationMs": 250,
  "barDurationMs": 1500
}

Input schema

{
  "type": "object",
  "required": [
    "numerator",
    "denominator"
  ],
  "properties": {
    "numerator": {
      "type": "number",
      "examples": [
        4,
        6
      ]
    },
    "denominator": {
      "type": "number",
      "examples": [
        4,
        8
      ]
    },
    "bpm": {
      "type": "number",
      "examples": [
        120
      ]
    },
    "bars": {
      "type": "number",
      "examples": [
        8
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}