{"uid":"cap_A6tRwkT6Yi9FX2JNO4GF8","slug":"brainiac-maritime-intelligence-demurrage-cost-calculator-ef0ec16a","name":"BRAINIAC Maritime Intelligence — Demurrage Cost Calculator","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/maritime-intelligence/demurrage-cost-calculate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"files":{"type":"array","items":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"maxItems":20},"vessels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"imo":{"type":"string","maxLength":20},"flag":{"type":"string","maxLength":80},"mmsi":{"type":"string","maxLength":20},"name":{"type":"string","maxLength":200},"owner":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"callSign":{"type":"string","maxLength":40},"operator":{"type":"string","maxLength":200},"vesselType":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":500},"aisPoints":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"imo":{"type":"string","maxLength":20},"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"mmsi":{"type":"string","maxLength":20},"sogKn":{"type":"number","maximum":100,"minimum":0},"cogDeg":{"type":"number","maximum":360,"minimum":0},"source":{"type":"string","maxLength":200},"vesselId":{"type":"string","maxLength":80},"navStatus":{"type":"string","maxLength":80},"headingDeg":{"type":"number","maximum":360,"minimum":0}},"additionalProperties":false},"maxItems":10000},"fetchOfac":{"type":"boolean"},"waypoints":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"name":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"sequence":{"type":"integer","maximum":10000,"minimum":0},"vesselId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":2000},"cargoEvents":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"side":{"enum":["document","ops","left","right","a","b"],"type":"string"},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"location":{"type":"string","maxLength":160},"quantity":{"type":"number","maximum":1000000000,"minimum":0},"vesselId":{"type":"string","maxLength":80},"eventType":{"type":"string","maxLength":80},"shipmentId":{"type":"string","maxLength":80},"billOfLading":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":5000},"portSamples":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"portCode":{"type":"string","maxLength":20},"portName":{"type":"string","maxLength":160},"arrivals24h":{"type":"number","maximum":100000,"minimum":0},"departures24h":{"type":"number","maximum":100000,"minimum":0},"vesselsWaiting":{"type":"number","maximum":100000,"minimum":0},"averageWaitHours":{"type":"number","maximum":10000,"minimum":0},"berthOccupancyPct":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":2000},"assumedSpeedKn":{"type":"number","maximum":50,"minimum":0.1},"demurrageCases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"endedAt":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"vesselId":{"type":"string","maxLength":80},"voyageId":{"type":"string","maxLength":80},"startedAt":{"type":"string","maxLength":40},"laytimeUsedHours":{"type":"number","maximum":100000,"minimum":0},"demurrageRatePerDay":{"type":"number","maximum":100000000,"minimum":0},"laytimeAllowedHours":{"type":"number","maximum":100000,"minimum":0}},"additionalProperties":false},"maxItems":500},"destinationLat":{"type":"number","maximum":90,"minimum":-90},"destinationLon":{"type":"number","maximum":180,"minimum":-180},"ownershipRecords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"to":{"type":"string","maxLength":40},"imo":{"type":"string","maxLength":20},"flag":{"type":"string","maxLength":80},"from":{"type":"string","maxLength":40},"owner":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"vesselId":{"type":"string","maxLength":80},"ownerType":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":2000},"sanctionsEntries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"imo":{"type":"string","maxLength":20},"name":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"program":{"type":"string","maxLength":120},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false},"maxItems":2000},"gapThresholdHours":{"type":"number","maximum":720,"minimum":0.1},"deviationThresholdKm":{"type":"number","maximum":5000,"minimum":0.1}}},"responseSchema":{"type":"json","example":{"items":[{"id":"D1","source":"Caller-supplied","currency":"USD","vesselId":"V1","voyageId":"VOY1","excessHours":24,"demurrageAmount":12000,"laytimeUsedHours":72,"demurrageRatePerDay":12000,"excessHoursSupplied":true,"laytimeAllowedHours":48,"legalInvoiceClaimed":false,"demurrageAmountSupplied":true,"laytimeUsedHoursSupplied":true,"demurrageRatePerDaySupplied":true,"laytimeAllowedHoursSupplied":true}],"status":"calculated","findings":[],"caseCount":1,"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Vessel identities, AIS points, waypoints, port samples, demurrage cases, sanctions entries, cargo events, and ownership records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.","No paid AIS service is used and no API key is required. Global real-time vessel coverage is not claimed.","Track gaps, route deviations, and ETA values use only supplied positions/speeds and simple geodesic math. Missing values are not invented.","Sanctions signals are name/IMO comparisons only. Exact matches are labeled as signals, not confirmed legal determinations. Possible matches require human review.","Demurrage amounts use only caller-supplied laytime and rate inputs and are not legal invoices."],"ofacFetched":false,"paidAisUsed":false,"apiKeyRequired":false,"paidProviderUsed":false,"totalDemurrageAmount":12000,"globalRealtimeCoverageClaimed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ic4fQRw2fp88ghe_CBj1j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates demurrage costs and excess laytime for one or more voyage cases using caller-supplied laytime allowances, rates, and usage data.","exampleAgentPrompt":"Calculate the demurrage cost for voyage VOY1 on vessel IMO 9876543 — laytime allowed was 48 hours, laytime used was 72 hours, and the demurrage rate is $12,000 per day in USD.","exampleUseCases":[{"title":"Single voyage demurrage audit","prompt":"I need to calculate demurrage for voyage VOY-2024-88: the vessel IMO 9123456 had 60 hours of allowed laytime but used 85 hours, with a rate of $15,000 per day in USD. What's the total demurrage owed?"},{"title":"Multi-case bulk cargo demurrage summary","prompt":"Here's a CSV with 10 demurrage cases from our Q3 bulk carrier voyages — each row has laytime allowed, laytime used, and the daily rate. Can you compute the total demurrage liability across all cases?"},{"title":"Charter party overage verification","prompt":"Our counterparty is claiming $24,000 in demurrage for vessel MMSI 338234567 on voyage VOY-COAL-05. Laytime allowed was 48 hours, they say we used 96 hours at $12,000 per day — does that math check out?"}],"resultDescription":"Returns a JSON object with an items array containing per-case results including vessel ID, voyage ID, excess hours, demurrage amount, laytime used and allowed, demurrage rate per day, and flags indicating which values were caller-supplied vs computed. Also includes overall status, case count, total demurrage amount, findings list, and a limitations section disclosing that all inputs are caller-supplied and results are not legal invoices.","failureModes":["Missing required laytime fields (allowed hours, used hours, rate) result in incomplete or null calculations","Malformed CSV or JSON input may cause parsing errors","Exceeding maxItems (500 vessels, 20 files) returns a validation error","Missing demurrage case objects with no identifying IDs produce unattributed results","Supplying contradictory data (e.g. laytime used less than allowed) results in zero excess hours with no demurrage charged"],"whenToPreferThis":"Use this endpoint when you need a fast, pay-per-call, no-account computation of demurrage costs from structured voyage data you already have — especially useful in agentic workflows where you want to validate or cross-check demurrage invoices, summarize multi-case laytime overages from a CSV, or programmatically compute charges without a full TMS integration. Not suited for fetching real-time AIS positions or generating legally binding demurrage invoices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:44.251Z","isFirstParty":false,"canonicalSlug":"brainiac-maritime-intelligence-demurrage-cost-calculator-ef0ec16a"}