# Structural Engineering Calculators API > Beam, truss and frame analysis, section properties, column buckling, load combinations, bolt and weld groups, footing bearing, retaining-wall stability, concrete flexure, composite transformed sections, deflection checks and tributary load takedown — pure numeric methods on caller inputs. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/structural-calcs - Docs: https://www.brainiac.software/api/structural-calcs/docs - OpenAPI: https://www.brainiac.software/api/structural-calcs/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/structural-calcs/beam-analysis $0.04 USDC. Euler-Bernoulli FEM for simply supported, cantilever, fixed and continuous beams with point, UDL, linear and moment loads. Inputs: length, E, I, supports, loads?, settlements?, points? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-beam-analysis Example request: ```json { "length": 6, "E": 200000000000, "I": 0.00008, "supports": [ { "x": 0, "type": "pin" }, { "x": 6, "type": "roller" } ], "loads": [ { "type": "udl", "w": -10000, "from": 0, "to": 6 } ], "settlements": [], "points": 61 } ``` Example response: ```json { "reactions": [ { "x": 0, "Fy": 29999.9999993, "M": 0 }, { "x": 6, "Fy": 29999.9999994, "M": 0 } ], "maxMoment": { "x": 3, "M": 44999.9999981 }, "minMoment": { "x": 0, "M": -6.78546106414e-7 }, "maxShear": 29999.9999994, "maxDeflection": { "x": 3, "dy": -0.0105468749996 }, "diagrams": [ { "x": 0, "V": 29999.9999993, "M": -6.78546106414e-7, "dy": 0, "rotation": -0.00562499999973 }, { "x": 0.1, "V": 28999.9999993, "M": 2949.99999925, "dy": -0.00056219010414, "rotation": -0.0056157291664 }, "…" ], "conditionEstimate": 24001.7777773, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Euler-Bernoulli beam FEM with consistent nodal loads; V/M recovered from element end forces plus exact in-element distr…", "Unstable support sets are reported as mechanism.", "…" ] } ``` ### POST /api/v1/structural-calcs/section-properties $0.03 USDC. Area, centroid, second moments, elastic/plastic moduli, radii of gyration and torsion constant for standard shapes or polygons with holes. Inputs: shape, params Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-section-properties Example request: ```json { "shape": "i_symmetric", "params": { "b": 200, "h": 400, "tf": 15, "tw": 10 } } ``` Example response: ```json { "A": 9700, "centroid": [ 100, 200 ], "Ix": 264660833.333, "Iy": 20030833.3333, "Ixy": 0, "Sx": 1323304.16667, "Sy": 200308.333333, "Zx": 1497250, "Zy": null, "rx": 165.180573898, "ry": 45.4426491774, "J": 573333.333333, "Jmethod": "thin-walled open: Σ b t³/3", "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Fillet radii are not modelled.", "Polygon properties use Green's theorem; plastic modulus Z uses equal-area axis bisection.", "…" ] } ``` ### POST /api/v1/structural-calcs/column-buckling $0.02 USDC. Elastic Euler and inelastic Johnson-parabola critical stress/load for a pin-ended equivalent column with caller K. Inputs: E, fy, A, I, length, K Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-column-buckling Example request: ```json { "E": 200000000000, "fy": 250000000, "A": 0.0097, "I": 0.000020030833, "length": 4, "K": 1 } ``` Example response: ```json { "slenderness": 88.0230379542, "transitionSlenderness": 125.663706144, "regime": "johnson", "eulerLoad": 2471204.96918, "eulerStress": 254763398.884, "criticalStress": 188668583.994, "criticalLoad": 1830085.26474, "r": 0.0454426487993, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Elastic Euler and inelastic Johnson parabola for a pin-ended equivalent column; K is caller-supplied.", "No resistance factors are applied.", "…" ] } ``` ### POST /api/v1/structural-calcs/load-combinations $0.01 USDC. Combine caller load-case results with caller factors and report the governing combination per result key. Inputs: cases, combinations, governBy? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-load-combinations Example request: ```json { "cases": { "D": { "M": 10, "V": 4 }, "L": { "M": 5, "V": 2 }, "W": { "M": 8, "V": 3 } }, "combinations": [ { "name": "C1", "factors": { "D": 1.4 } }, { "name": "C2", "factors": { "D": 1.2, "L": 1.6 } }, { "name": "C3", "factors": { "D": 1.2, "L": 1, "W": 1 } }, { "name": "C4", "factors": { "D": 0.9, "W": -1 } } ], "governBy": "absolute" } ``` Example response: ```json { "results": [ { "combination": "C1", "M": 14, "V": 5.6 }, { "combination": "C2", "M": 20, "V": 8 }, "…" ], "governing": { "M": { "combination": "C3", "value": 25 }, "V": { "combination": "C3", "value": 9.8 } }, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Combination factors are caller-supplied; ASCE 7 / Eurocode factors are not embedded.", "Outputs are calculation aids for a qualified engineer on caller-supplied inputs. They are not stamped designs, code com…", "…" ] } ``` ### POST /api/v1/structural-calcs/truss-2d-analysis $0.04 USDC. Direct-stiffness truss analysis returning member axial forces, support reactions and joint displacements. Inputs: nodes, members, loads? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-truss-2d-analysis Example request: ```json { "nodes": [ { "id": "A", "x": 0, "y": 0, "support": "pin" }, { "id": "B", "x": 4, "y": 0, "support": "roller_y" }, { "id": "C", "x": 2, "y": 3 } ], "members": [ { "id": "AB", "i": "A", "j": "B", "E": 200000000000, "A": 0.001 }, { "id": "AC", "i": "A", "j": "C", "E": 200000000000, "A": 0.001 }, { "id": "BC", "i": "B", "j": "C", "E": 200000000000, "A": 0.001 } ], "loads": [ { "node": "C", "Fx": 0, "Fy": -10000 } ] } ``` Example response: ```json { "memberForces": [ { "id": "AB", "force": 3333.33333333, "state": "tension" }, { "id": "AC", "force": -6009.25212577, "state": "compression" }, "…" ], "reactions": [ { "node": "A", "Rx": 4.54747350886e-13, "Ry": 5000 }, { "node": "B", "Ry": 5000 } ], "displacements": [ { "node": "A", "dx": 0, "dy": 0 }, { "node": "B", "dx": 0.0000666666666667, "dy": 0 }, "…" ], "conditionEstimate": 2.25120355688, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "2D pin-jointed truss by direct stiffness; tension positive. Mechanism if reduced matrix is singular.", "Outputs are calculation aids for a qualified engineer on caller-supplied inputs. They are not stamped designs, code com…", "…" ] } ``` ### POST /api/v1/structural-calcs/frame-2d-analysis $0.05 USDC. Euler-Bernoulli frame analysis with optional moment releases, nodal and member loads, returning displacements, reactions and member end forces. Inputs: nodes, members, nodalLoads?, memberLoads? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-frame-2d-analysis Example request: ```json { "nodes": [ { "id": "1", "x": 0, "y": 0, "support": "fixed" }, { "id": "2", "x": 0, "y": 4 }, { "id": "3", "x": 6, "y": 4 }, { "id": "4", "x": 6, "y": 0, "support": "fixed" } ], "members": [ { "id": "c1", "i": "1", "j": "2", "E": 200000000000, "A": 0.01, "I": 0.0001 }, { "id": "b", "i": "2", "j": "3", "E": 200000000000, "A": 0.01, "I": 0.0001 }, { "id": "c2", "i": "4", "j": "3", "E": 200000000000, "A": 0.01, "I": 0.0001 } ], "nodalLoads": [ { "node": "2", "Fx": 10000 } ], "memberLoads": [] } ``` Example response: ```json { "displacements": [ { "node": "1", "dx": 0, "dy": 0, "rz": 0 }, { "node": "2", "dx": 0.00214365683991, "dy": 0.00000532859680284, "rz": -0.000403525155851 }, "…" ], "reactions": [ { "node": "1", "Rx": -5012.27448077, "Ry": -2664.29840142, "Mz": 12042.1747408 }, { "node": "4", "Rx": -4987.72551923, "Ry": 2664.29840142, "Mz": 11972.0348507 } ], "memberEndForces": [ { "id": "c1", "i": { "N": -2664.29840142, "V": 5012.27448077, "M": 12042.1747408 }, "j": { "N": 2664.29840142, "V": -5012.27448077, "M": 8006.92318229 } }, { "id": "b", "i": { "N": 4987.72551923, "V": -2664.29840142, "M": -8006.92318229 }, "j": { "N": -4987.72551923, "V": 2664.29840142, "M": -7978.86722624 } }, "…" ], "conditionEstimate": 83.3353415505, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "2D Euler-Bernoulli frame elements with optional moment releases; P-delta and shear deformation not included.", "End forces = k·T·u − fixed-end forces from member loads.", "…" ] } ``` ### POST /api/v1/structural-calcs/bolt-group-eccentric $0.02 USDC. Elastic-method force distribution in an in-plane eccentrically loaded bolt group. Inputs: bolts, load Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-bolt-group-eccentric Example request: ```json { "bolts": [ [ 50, 75 ], [ -50, 75 ], [ 50, -75 ], [ -50, -75 ] ], "load": { "Px": 0, "Py": -100, "x": 200, "y": 0 } } ``` Example response: ```json { "centroid": [ 0, 0 ], "polarMoment": 32500, "moment": -20000, "bolts": [ { "x": 50, "y": 75, "fx": 46.1538461538, "fy": -55.7692307692, "resultant": 72.3905008643 }, { "x": -50, "y": 75, "fx": 46.1538461538, "fy": 5.76923076923, "resultant": 46.513025471 }, "…" ], "maxBoltForce": 72.3905008643, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Elastic method for in-plane eccentric bolt groups; instantaneous-centre method is not included.", "Outputs are calculation aids for a qualified engineer on caller-supplied inputs. They are not stamped designs, code com…", "…" ] } ``` ### POST /api/v1/structural-calcs/weld-group-analysis $0.02 USDC. Elastic line-weld analysis of an eccentrically loaded weld group returning maximum force per unit length. Inputs: lines, load Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-weld-group-analysis Example request: ```json { "lines": [ { "from": [ -50, -75 ], "to": [ -50, 75 ] }, { "from": [ 50, -75 ], "to": [ 50, 75 ] } ], "load": { "Px": 0, "Py": -100, "x": 200, "y": 0 } } ``` Example response: ```json { "length": 300, "centroid": [ 0, 0 ], "Ip": 1312500, "maxForcePerLength": 1.58293048939, "critical": [ 50, -75 ], "components": { "direct": 0.333333333333, "torsionX": -1.14285714286, "torsionY": -0.761904761905 }, "moment": -20000, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Elastic line-weld analysis with unit throat; throat/strength checks are left to the caller's code.", "Outputs are calculation aids for a qualified engineer on caller-supplied inputs. They are not stamped designs, code com…", "…" ] } ``` ### POST /api/v1/structural-calcs/footing-bearing-pressure $0.03 USDC. Soil bearing pressure under a rectangular footing with axial load and moments, including partial uplift. Inputs: B, L, P, Mx?, My? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-footing-bearing-pressure Example request: ```json { "B": 2.5, "L": 2.5, "P": 1000, "Mx": 200, "My": 0 } ``` Example response: ```json { "ex": 0.2, "ey": 0, "withinKern": true, "qMax": 236.8, "qMin": 83.2, "contactLengthB": 2.5, "contactLengthL": 2.5, "cornerPressures": [ 236.8, 236.8, "…" ], "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Bearing under rectangular footing; biaxial within kern uses elastic corner formula.", "Outputs are calculation aids for a qualified engineer on caller-supplied inputs. They are not stamped designs, code com…", "…" ] } ``` ### POST /api/v1/structural-calcs/retaining-wall-stability $0.03 USDC. Overturning, sliding and bearing checks for a cantilever retaining wall with Rankine or Coulomb active pressure. Inputs: geometry, soil, concreteGamma, baseFriction, surcharge?, theory?, wallFriction?, waterTableDepth?, passiveIgnored? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-retaining-wall-stability Example request: ```json { "geometry": { "totalHeight": 4, "baseThickness": 0.5, "baseWidth": 2.8, "toe": 0.6, "stemThickness": 0.4 }, "soil": { "gamma": 18, "phi": 30, "cohesion": 0 }, "concreteGamma": 24, "baseFriction": 0.5, "surcharge": 0, "theory": "rankine", "waterTableDepth": null, "passiveIgnored": true } ``` Example response: ```json { "Ka": 0.333333333333, "activeForce": 48, "activeArm": 1.33333333333, "verticalTotal": 180.6, "resistingMoment": 289.38, "overturningMoment": 64, "fsOverturning": 4.5215625, "fsSliding": 1.88125, "eccentricity": 0.152048726467, "qToe": 85.5153061224, "qHeel": 43.4846938776, "withinMiddleThird": true, "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Rankine or Coulomb active pressure on the vertical plane through the heel; seismic and passive resistance excluded when…", "Bearing uses middle-third / triangular uplift formulas about the toe.", "…" ] } ``` ### POST /api/v1/structural-calcs/concrete-rect-flexure $0.03 USDC. Nominal flexural strength of a singly or doubly reinforced rectangular section with caller stress-block parameters. Inputs: b, d, As, fc, fy, Es?, beta1, alpha1, epsCu, AsPrime?, dPrime?, phi? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-concrete-rect-flexure Example request: ```json { "b": 300, "d": 500, "As": 1500, "fc": 30, "fy": 420, "Es": 200000, "beta1": 0.836, "alpha1": 0.85, "epsCu": 0.003, "AsPrime": 0, "dPrime": 0, "phi": null } ``` Example response: ```json { "a": 82.3529411765, "c": 98.5083028427, "Mn": 289.058823529, "phiMn": null, "epsT": 0.0122271428571, "steelYields": true, "compressionSteelYields": null, "classification": "tension_controlled_strain_gt_0.005", "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Equivalent rectangular stress block with caller α1, β1, εcu; ACI/Eurocode values are not looked up.", "Mn in kN·m from mm / MPa inputs.", "…" ] } ``` ### POST /api/v1/structural-calcs/composite-section-transform $0.03 USDC. Modular-ratio transformed-section properties and stresses for multi-material sections, optionally cracked. Inputs: reference, parts, moment?, concreteCracked? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-composite-section-transform Example request: ```json { "reference": "timber", "parts": [ { "name": "timber", "shape": "rectangle", "b": 100, "h": 250, "y0": 0, "E": 10000 }, { "name": "steel", "shape": "rectangle", "b": 10, "h": 250, "y0": 0, "E": 200000 } ], "moment": 20000000, "concreteCracked": false } ``` Example response: ```json { "modularRatios": { "timber": 1, "steel": 20 }, "transformedArea": 75000, "neutralAxis": 125, "Itr": 390625000, "stresses": [ { "part": "timber", "maxStress": 6.4 }, { "part": "steel", "maxStress": 128 } ], "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Transformed-section properties with modular ratios n_i = E_i/E_ref; cracked concrete iterates the neutral axis.", "Stress in part i = n_i·M·y/I_tr.", "…" ] } ``` ### POST /api/v1/structural-calcs/deflection-limit-check $0.01 USDC. Compare computed deflections with caller span/deflection limits and optional long-term multipliers. Inputs: span, checks, absoluteLimit? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-deflection-limit-check Example request: ```json { "span": 6, "checks": [ { "case": "live", "deflection": 0.010547, "limitRatio": 360 }, { "case": "total_long_term", "deflection": 0.010547, "multiplier": 2, "limitRatio": 240 } ], "absoluteLimit": null } ``` Example response: ```json { "results": [ { "case": "live", "deflection": 0.010547, "limit": 0.0166666666667, "utilisation": 0.63282, "pass": true }, { "case": "total_long_term", "deflection": 0.021094, "limit": 0.025, "utilisation": 0.84376, "pass": true } ], "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Limits and long-term multipliers are caller-supplied; no code table is embedded.", "Outputs are calculation aids for a qualified engineer on caller-supplied inputs. They are not stamped designs, code com…", "…" ] } ``` ### POST /api/v1/structural-calcs/tributary-load-takedown $0.02 USDC. Tributary areas on a rectangular grid (or caller polygons) with cumulative dead/live takedown over floors. Inputs: gridX?, gridY?, floors, factors?, omittedColumns?, columns? Docs: https://www.brainiac.software/api/structural-calcs/docs#structural-calcs-tributary-load-takedown Example request: ```json { "gridX": [ 0, 6, 12, 18 ], "gridY": [ 0, 5, 10 ], "floors": [ { "name": "Roof", "dead": 3, "live": 1 }, { "name": "L2", "dead": 4, "live": 2.5 }, { "name": "L1", "dead": 4, "live": 2.5 } ], "factors": null, "omittedColumns": [] } ``` Example response: ```json { "columns": [ { "id": "x0y0", "x": 0, "y": 0, "tributaryArea": 7.5, "byFloor": [ { "floor": "Roof", "dead": 22.5, "live": 7.5 }, { "floor": "L2", "dead": 30, "live": 18.75 }, "…" ], "cumulative": { "dead": 82.5, "live": 45 } }, { "id": "x0y1", "x": 0, "y": 5, "tributaryArea": 15, "byFloor": [ { "floor": "Roof", "dead": 45, "live": 15 }, { "floor": "L2", "dead": 60, "live": 37.5 }, "…" ], "cumulative": { "dead": 165, "live": 90 } }, "…" ], "sources": [ { "source": "Caller-supplied geometry, loads, material and factor inputs processed locally", "url": "https://www.brainiac.software/api/v1/structural-calcs", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Rectangular-grid tributary widths are half the adjacent bay; live-load reduction is not applied.", "Outputs are calculation aids for a qualified engineer on caller-supplied inputs. They are not stamped designs, code com…", "…" ] } ```