{"openapi":"3.1.0","info":{"title":"Jewelry Maker Calc","version":"1.0.0","description":"Ring size conversion, bead counts, necklace and bracelet lengths, metal weight, carat estimates, karat alloy mixing and melt value. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Jewelry Maker Calc: Ring size conversion, bead counts, necklace and bracelet lengths, metal weight, carat estimates, karat alloy mixing and melt value. Use /ring-size to convert US, EU and diameter sizes, /bead-count for beads per strand, /necklace-length to name a chain length, /bracelet-size for wrist fit, /metal-weight for casting weights, /diamond-weight to estimate carats from millimetres, /karat-alloy to mix gold alloys and /melt-value to value the metal content. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://jewelry-calc.x402tookit.com"}],"paths":{"/bead-count":{"get":{"operationId":"bead_count","summary":"Number of beads for a strand of a given finished length from bead size and spacing, with finished length and total weight.","description":"Number of beads for a strand of a given finished length from bead size and spacing, with finished length and total weight.","tags":["beads","strand","necklace","bracelet"],"parameters":[{"name":"lengthInches","in":"query","required":false,"description":"Finished strand length in inches (use lengthInches or lengthCm)","schema":{"type":"number"}},{"name":"lengthCm","in":"query","required":false,"description":"Finished strand length in cm instead of inches","schema":{"type":"number"}},{"name":"beadMm","in":"query","required":true,"description":"Bead diameter (length along the strand) in mm","schema":{"type":"number"}},{"name":"spacingMm","in":"query","required":false,"description":"Extra space between beads (spacers, knots, wire loops) in mm (default 0)","schema":{"type":"number"}},{"name":"claspMm","in":"query","required":false,"description":"Length taken by the clasp and end findings in mm (default 0)","schema":{"type":"number"}},{"name":"gramsPerBead","in":"query","required":false,"description":"Weight of one bead in grams, for the total","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"beads":{"type":["null","number"]},"pitchMm":{"type":["null","number"]},"usableMm":{"type":["null","number"]},"finishedLengthMm":{"type":["null","number"]},"finishedLengthInches":{"type":["null","number"]},"shortOfTargetMm":{"type":["null","number"]},"withOneMoreBeadInches":{"type":["null","number"]},"beadsPerInch":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"67 bead(s) of 6 mm make 15.83 in (target 16 in).","reasons":["Each bead takes 6 mm of strand; 4.4 mm is left over."],"beads":67,"pitchMm":6,"usableMm":406.4,"finishedLengthMm":402,"finishedLengthInches":15.827,"shortOfTargetMm":4.4,"withOneMoreBeadInches":16.063,"beadsPerInch":4.233,"degraded":false,"notChecked":["bead hole tolerances and uneven natural beads (measure a real inch of strung beads)","knots between beads, which add length","…1 more"],"source":"computed locally (length / (bead + spacing))","asOf":"2026-10-12T01:40:58.211Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bead-count"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bead-count"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bead-count"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bead-count"}}]}}},"/bracelet-size":{"get":{"operationId":"bracelet_size","summary":"Bracelet or anklet length from wrist or ankle circumference and fit (snug, standard, comfortable, loose), with clasp allowance.","description":"Bracelet or anklet length from wrist or ankle circumference and fit (snug, standard, comfortable, loose), with clasp allowance.","tags":["bracelet","anklet","size","jewelry"],"parameters":[{"name":"circumferenceInches","in":"query","required":true,"description":"Wrist or ankle circumference in inches (measure with a soft tape; use circumferenceCm for cm)","schema":{"type":"number"}},{"name":"fit","in":"query","required":false,"description":"snug (+0.25 in), standard (+0.5, default), comfortable (+1) or loose (+1.5)","schema":{"type":"string"}},{"name":"unit","in":"query","required":false,"description":"in (default) or cm for the circumference value","schema":{"type":"string"}},{"name":"claspInches","in":"query","required":false,"description":"Length the clasp adds beyond the chain or beads, 0 to 2 in (default 0.5)","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"circumferenceInches":{"type":["null","number"]},"circumferenceCm":{"type":["null","number"]},"fit":{"type":["null","string"]},"easeInches":{"type":["null","number"]},"finishedLengthInches":{"type":["null","number"]},"finishedLengthCm":{"type":["null","number"]},"bodyLengthInches":{"type":["null","number"]},"allFitsInches":{"type":["null","object"],"properties":{"snug":{"type":["null","number"]},"standard":{"type":["null","number"]},"comfortable":{"type":["null","number"]},"loose":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"For a 6.5 in wrist at standard fit make the bracelet 7 in (17.8 cm) including the clasp; 6.5 in of chain or beads.","reasons":["Ease for standard fit is 0.5 in.","The 0.5 in clasp is counted inside the total."],"circumferenceInches":6.5,"circumferenceCm":16.51,"fit":"standard","easeInches":0.5,"finishedLengthInches":7,"finishedLengthCm":17.78,"bodyLengthInches":6.5,"allFitsInches":{"snug":6.75,"standard":7,"comfortable":7.5,"loose":8},"degraded":false,"notChecked":["wrist bone size, which may need a bigger ease than the table","flexible versus rigid bangles (a rigid bangle must clear the hand, so measure that separately)","…1 more"],"source":"computed locally (circumference + ease)","asOf":"2026-10-12T01:40:58.474Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bracelet-size"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bracelet-size"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bracelet-size"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/bracelet-size"}}]}}},"/diamond-weight":{"get":{"operationId":"diamond_weight","summary":"Estimate a diamond's carats from millimetre size and shape, or the diameter of a round stone for a given carat weight.","description":"Estimate a diamond's carats from millimetre size and shape, or the diameter of a round stone for a given carat weight.","tags":["diamond","carat","gemstone","estimate"],"parameters":[{"name":"shape","in":"query","required":false,"description":"round, princess, oval, emerald, cushion, pear, marquise, heart (default round)","schema":{"type":"string"}},{"name":"lengthMm","in":"query","required":false,"description":"Length (or diameter for round) in mm (use lengthMm or carats)","schema":{"type":"number"}},{"name":"widthMm","in":"query","required":false,"description":"Width in mm (defaults to the length; required for non-round shapes)","schema":{"type":"number"}},{"name":"depthPercent","in":"query","required":false,"description":"Depth as a percent of width (default 61 for round, 65 for fancy shapes)","schema":{"type":"number"}},{"name":"carats","in":"query","required":false,"description":"A carat weight, to get the typical round-stone diameter","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"shape":{"type":["null","string"]},"lengthMm":{"type":["null","number"]},"widthMm":{"type":["null","number"]},"depthPercent":{"type":["null","number"]},"depthMm":{"type":["null","number"]},"factor":{"type":["null","number"]},"estimatedCarats":{"type":["null","number"]},"estimatedGrams":{"type":["null","number"]},"estimatedPoints":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"6.5 mm round at 61% depth is about 1.02 ct.","reasons":["carat = 6.5 x 6.5 x 3.97 x 0.0061 (round factor).","Treat this as an estimate within about 10%."],"shape":"round","lengthMm":6.5,"widthMm":6.5,"depthPercent":61,"depthMm":3.965,"factor":0.0061,"estimatedCarats":1.022,"estimatedGrams":0.204,"estimatedPoints":102,"degraded":false,"notChecked":["the actual cut, girdle thickness and proportions, which move the weight by 10% or more","gem density: factors assume diamond (other gems of the same size weigh differently)","…1 more"],"source":"computed locally (carat = length x width x depth x shape factor; factors are common published approximations)","asOf":"2026-10-12T01:40:58.737Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/diamond-weight"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/diamond-weight"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/diamond-weight"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/diamond-weight"}}]}}},"/karat-alloy":{"get":{"operationId":"karat_alloy","summary":"Gold karat to fineness and percent, and the alloy to add to fine gold to reach a target karat, or the karat of a mix.","description":"Gold karat to fineness and percent, and the alloy to add to fine gold to reach a target karat, or the karat of a mix.","tags":["gold","karat","alloy","fineness"],"parameters":[{"name":"karat","in":"query","required":false,"description":"A karat from 1 to 24 (for the fineness and alloy mix)","schema":{"type":"number"}},{"name":"fineGoldGrams","in":"query","required":false,"description":"Grams of fine (24k) gold you start with, to get the alloy needed for the target karat","schema":{"type":"number"}},{"name":"goldGrams","in":"query","required":false,"description":"Alternative: grams of gold at mixKarat1 to combine with mixGrams2 (see mix fields)","schema":{"type":"number"}},{"name":"mixKarat1","in":"query","required":false,"description":"Karat of the first piece, for the mix calculation","schema":{"type":"number"}},{"name":"mixGrams2","in":"query","required":false,"description":"Grams of the second piece","schema":{"type":"number"}},{"name":"mixKarat2","in":"query","required":false,"description":"Karat of the second piece (0 for pure alloy metal)","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"karat":{"type":["null","number"]},"goldPercent":{"type":["null","number"]},"fineness":{"type":["null","number"]},"finenessExact":{"type":["null","number"]},"alloyPercent":{"type":["null","number"]},"fineGoldGrams":{"type":["null","number"]},"totalAlloyedGrams":{"type":["null","number"]},"alloyMetalToAddGrams":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"18k is 75% gold, fineness 750; 10 g of fine gold needs 3.333 g of alloy metal to make 13.333 g of 18k.","reasons":["Hallmark fineness is usually the rounded standard value: 9k 375, 10k 417, 14k 585, 18k 750, 22k 916, 24k 999."],"karat":18,"goldPercent":75,"fineness":750,"finenessExact":750,"alloyPercent":25,"fineGoldGrams":10,"totalAlloyedGrams":13.3333,"alloyMetalToAddGrams":3.3333,"degraded":false,"notChecked":["hallmark rules and legal minimum fineness in your country (for example 9k, 10k, 14k, 18k, 375/585/750)","alloy composition for colour (white, rose, green gold use different metals)","…1 more"],"source":"computed locally (karat / 24 = gold fraction)","asOf":"2026-10-12T01:40:59.000Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/karat-alloy"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/karat-alloy"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/karat-alloy"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/karat-alloy"}}]}}},"/melt-value":{"get":{"operationId":"melt_value","summary":"Melt value of gold, silver or platinum jewelry from weight, karat or fineness and the spot price per troy ounce you supply.","description":"Melt value of gold, silver or platinum jewelry from weight, karat or fineness and the spot price per troy ounce you supply.","tags":["melt-value","gold","silver","scrap"],"parameters":[{"name":"grams","in":"query","required":true,"description":"Total weight of the piece (grams unless weightUnit says otherwise)","schema":{"type":"number"}},{"name":"weightUnit","in":"query","required":false,"description":"g (default), dwt, ozt (troy ounces) or oz (avoirdupois ounces)","schema":{"type":"string"}},{"name":"karat","in":"query","required":false,"description":"Gold karat 1 to 24 (use karat or fineness)","schema":{"type":"number"}},{"name":"fineness","in":"query","required":false,"description":"Fineness per thousand, for example 925 for sterling or 750 for 18k","schema":{"type":"number"}},{"name":"spotPerTroyOunce","in":"query","required":true,"description":"The metal's price per troy ounce, in your currency (you supply it; none is built in)","schema":{"type":"number"}},{"name":"payoutPercent","in":"query","required":false,"description":"Share of melt value a buyer pays, 1 to 100 (default 100)","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"pieceGrams":{"type":["null","number"]},"purityPercent":{"type":["null","number"]},"pureMetalGrams":{"type":["null","number"]},"pureMetalTroyOunces":{"type":["null","number"]},"pureMetalDwt":{"type":["null","number"]},"spotPerTroyOunce":{"type":["null","number"]},"meltValue":{"type":["null","number"]},"payoutPercent":{"type":["null","number"]},"meltValueAtPayout":{"type":["null","number"]},"meltValuePerGramOfPiece":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"12.4 g at 58.33% holds 7.233 g (0.2326 troy oz) of pure metal, worth 465.11 at 2000 per troy oz.","reasons":["Melt value is the metal content at the spot price, before any refining cost or dealer margin."],"pieceGrams":12.4,"purityPercent":58.333,"pureMetalGrams":7.2333,"pureMetalTroyOunces":0.23256,"pureMetalDwt":4.651,"spotPerTroyOunce":2000,"meltValue":465.11,"payoutPercent":100,"meltValueAtPayout":465.11,"meltValuePerGramOfPiece":37.5092,"degraded":false,"notChecked":["the live market price (you supply it)","refiner fees, assay charges and dealer margins, which cut real payouts well below melt value","…2 more"],"source":"computed locally (weight x purity x price / 31.1034768)","asOf":"2026-10-12T01:40:59.262Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/melt-value"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/melt-value"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/melt-value"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/melt-value"}}]}}},"/metal-weight":{"get":{"operationId":"metal_weight","summary":"Casting weight in grams, pennyweight and troy ounces from volume or wax model weight, for gold, silver, platinum and more.","description":"Casting weight in grams, pennyweight and troy ounces from volume or wax model weight, for gold, silver, platinum and more.","tags":["casting","metal","weight","density"],"parameters":[{"name":"metal","in":"query","required":true,"description":"One of: fine-gold-24k, yellow-gold-18k, yellow-gold-14k, yellow-gold-10k, white-gold-14k, rose-gold-14k, sterling-silver, fine-silver, platinum, palladium, brass, bronze, copper, titanium, stainless-steel","schema":{"type":"string"}},{"name":"volumeCm3","in":"query","required":false,"description":"Piece volume in cubic centimetres (use this or waxGrams or volumeMm3)","schema":{"type":"number"}},{"name":"volumeMm3","in":"query","required":false,"description":"Piece volume in cubic millimetres","schema":{"type":"number"}},{"name":"waxGrams","in":"query","required":false,"description":"Weight of the wax model in grams (lost-wax casting)","schema":{"type":"number"}},{"name":"waxDensity","in":"query","required":false,"description":"Wax density in g/cm3 for waxGrams (default 0.95)","schema":{"type":"number"}},{"name":"wastePercent","in":"query","required":false,"description":"Extra metal for sprues and button as a percent of the piece (default 0)","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"metal":{"type":["null","string"]},"densityGramsPerCm3":{"type":["null","number"]},"volumeCm3":{"type":["null","number"]},"pieceGrams":{"type":["null","number"]},"pieceDwt":{"type":["null","number"]},"pieceTroyOunces":{"type":["null","number"]},"withWasteGrams":{"type":["null","number"]},"wastePercent":{"type":["null","number"]},"withWasteTroyOunces":{"type":["null","number"]},"waxToMetalFactor":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"8.29 g of sterling-silver (5.33 dwt, 0.266 troy oz).","reasons":["Density used: 10.36 g/cm3 for sterling-silver.","Weight = volume x density."],"metal":"sterling-silver","densityGramsPerCm3":10.36,"volumeCm3":0.8,"pieceGrams":8.288,"pieceDwt":5.329,"pieceTroyOunces":0.2665,"withWasteGrams":8.288,"wastePercent":0,"withWasteTroyOunces":0.2665,"waxToMetalFactor":10.905,"degraded":false,"notChecked":["exact alloy density (it varies by maker and recipe)","shrinkage and porosity in real castings","…1 more"],"source":"computed locally (weight = volume x density)","asOf":"2026-10-12T01:40:59.525Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/metal-weight"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/metal-weight"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/metal-weight"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/metal-weight"}}]}}},"/necklace-length":{"get":{"operationId":"necklace_length","summary":"Name a necklace length (choker, princess, matinee, opera, rope) and where it sits, or suggest a length from neck size.","description":"Name a necklace length (choker, princess, matinee, opera, rope) and where it sits, or suggest a length from neck size.","tags":["necklace","chain","length","jewelry"],"parameters":[{"name":"lengthInches","in":"query","required":false,"description":"A chain length in inches, to name it (use this or style)","schema":{"type":"number"}},{"name":"style","in":"query","required":false,"description":"collar, choker, princess, matinee, opera or rope, to get its length range","schema":{"type":"string"}},{"name":"neckInches","in":"query","required":false,"description":"Neck circumference in inches, to suggest a length per style (add the clasp allowance)","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"lengthInches":{"type":["null","number"]},"lengthCm":{"type":["null","number"]},"style":{"type":["null","string"]},"sitsAt":{"type":["null","string"]},"neckInches":{"type":["null","number"]},"snugChokerInches":{"type":["null","number"]},"comfortableChokerInches":{"type":["null","number"]},"princessSuggestionInches":{"type":["null","number"]},"clasp":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"18 in (45.7 cm) is a princess: rests on the collarbone.","reasons":["Names follow the common retail convention; ranges overlap by a half inch or so."],"lengthInches":18,"lengthCm":45.7,"style":"princess","sitsAt":"rests on the collarbone","neckInches":14,"snugChokerInches":14.5,"comfortableChokerInches":15.5,"princessSuggestionInches":18,"clasp":"Chain lengths are usually quoted as the closed loop, including the clasp.","degraded":false,"notChecked":["body size and shape, which change where a chain actually falls","pendant drop and clasp type","…1 more"],"source":"computed locally (standard necklace length names)","asOf":"2026-10-12T01:40:59.788Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/necklace-length"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/necklace-length"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/necklace-length"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/necklace-length"}}]}}},"/ring-size":{"get":{"operationId":"ring_size","summary":"Convert a ring size between US, EU (ISO circumference), UK letter, inside diameter and circumference in mm and inches.","description":"Convert a ring size between US, EU (ISO circumference), UK letter, inside diameter and circumference in mm and inches.","tags":["ring-size","conversion","jewelry","etsy"],"parameters":[{"name":"usSize","in":"query","required":false,"description":"US ring size, 0 to 16 (use exactly one input)","schema":{"type":"number"}},{"name":"euSize","in":"query","required":false,"description":"EU / ISO size = inside circumference in mm","schema":{"type":"number"}},{"name":"diameterMm","in":"query","required":false,"description":"Inside diameter in mm","schema":{"type":"number"}},{"name":"circumferenceMm","in":"query","required":false,"description":"Inside circumference in mm","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"usSize":{"type":["null","number"]},"usSizeNearestQuarter":{"type":["null","number"]},"euSize":{"type":["null","number"]},"ukSize":{"type":["null","string"]},"diameterMm":{"type":["null","number"]},"circumferenceMm":{"type":["null","number"]},"diameterInches":{"type":["null","number"]},"circumferenceInches":{"type":["null","number"]},"mmPerFullUsSize":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"US 7 = EU 54 = UK N½; inside diameter 17.32 mm, circumference 54.4 mm.","reasons":["EU (ISO 8653) sizes are the inside circumference in millimetres, rounded to a whole number."],"usSize":7,"usSizeNearestQuarter":7,"euSize":54,"ukSize":"N½","diameterMm":17.32,"circumferenceMm":54.41,"diameterInches":0.6819,"circumferenceInches":2.1422,"mmPerFullUsSize":0.8128,"degraded":false,"notChecked":["brand and manufacturer differences (many sizes run a half size either way)","knuckle size, band width (wide bands need a bigger size) and finger swelling through the day","…1 more"],"source":"computed locally (ISO 8653 circumference; US size = (diameter - 11.63) / 0.8128; UK letters from 37.8 mm + 1.25 mm per letter)","asOf":"2026-10-12T01:41:00.053Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/ring-size"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/ring-size"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/ring-size"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://jewelry-calc.x402tookit.com/ring-size"}}]}}}}}