Date Math

active

Deterministic date and time math for AI agents: date differences, business days, date arithmetic, time zone conversion and calendar facts. Paid per call via x402 (USDC on Base, $0.001); probes and spec are free. All inputs are JSON bodies; all responses are JSON objects. Errors return {"error":{"code","message","example"}}.

Settled via Coinbase, PayAI.

Transactions · 30d
78
Volume · 30d
$0.078
Unique buyers · 30d
10
Uptime · 30d
54.4%
Latency p50
34ms
Reported calls · 30d
59

Endpoints (46 live)

  • POST /v1/holidays — Date Math: Public holidays for a country and year: 207 countries, 2000–2050. Lunar or government-proclaimed dates are rule-based estimates. (0.001 USDC on Base)
  • POST /v1/add — Date Math: Add or subtract years/months/weeks/days/business days/hours/minutes/seconds; month-end clamping; skips weekends and holidays. (0.001 USDC on Base)
  • POST /v1/info — Date Math: Calendar facts for a date: weekday, ISO week, quarter, day of year, leap year, weekend. (0.001 USDC on Base)
  • POST /v1/diff — Date Math: Difference between two dates or datetimes: calendar (Y/M/D), total days/weeks/hours, business days with custom holidays. (0.001 USDC on Base)
  • POST /v1/convert — Date Math: Convert an instant or local wall-clock time between IANA time zones (DST-aware). (0.001 USDC on Base)
  • POST /v1/subscription — Date Math: Subscription and contract date math: current billing period, next renewal, upcoming renewals, cancel-by date for a notice period, free-trial start, and day-based proration of a price. Month-end anchors stay at month end (Jan 31, Feb 28, Mar 31). Use for SaaS billing, renewals, cancellation deadlines and refunds. (0.001 USDC on Base)
  • POST /v1/city — Date Math: Find the time zone and current local time in up to 10 cities by name ("Cebu", "São Paulo", "Springfield" + country). 7,000+ cities. Use for "what time is it in" questions and to get the IANA zone the other tools need. (0.001 USDC on Base)
  • POST /v1/business_day — Date Math: Is a date a business day? If not, why (weekend, or which public holiday). Also the next and previous business day, and the month's business-day count, first and last business day. Use for office-open checks, shipping cut-offs, settlement dates. Country holidays, custom holidays and custom workweeks (e.g. Sun–Thu, Mon–Sat). (0.001 USDC on Base)
  • POST /v1/recurrence — Date Math: Expand a recurring event or iCalendar RRULE ("every 2nd Tuesday", "Mon/Wed until June") into concrete dates and times in a time zone, DST-aware, with optional excluded dates. Use for repeating meetings, calendar invites and schedules. (0.001 USDC on Base)
  • POST /v1/cron — Date Math: Explain a cron expression in plain English and list its next run times in any time zone. Use to check or debug crontab and scheduled-job schedules. (0.001 USDC on Base)
  • POST /v1/pay_dates — Date Math: Upcoming pay or billing dates for monthly, semi-monthly (e.g. 15th and last day), biweekly or weekly schedules, moved off weekends and public holidays (to the previous, next or nearest business day). Use for payroll calendars, invoice due dates and recurring billing. (0.001 USDC on Base)
  • POST /v1/business_hours — Date Math: SLA math in working hours: the deadline N business hours after a start time, or business time elapsed between two times. Use for support-ticket SLAs, response-time targets and office-hours deadlines. Custom hours and workdays, holidays, country public holidays, DST-aware. (0.001 USDC on Base)
  • POST /v1/timestamp — Date Math: Detect and convert up to 100 mixed timestamps to UTC ISO 8601: Unix seconds/ms/µs/ns, Excel serial dates, Windows FILETIME, ISO 8601, RFC 2822, YYYY/MM/DD, month-name dates. Flags ambiguous values (03/04/2026: March 4 or 3 April? 45000: Excel date or Unix seconds?) with alternatives. Use for cleaning CSV, log and spreadsheet data. (0.001 USDC on Base)
  • POST /v1/sla — Date Math: Live SLA clock for a support ticket: business minutes elapsed and remaining, breached or not, and the deadline. The clock pauses outside working hours, on weekends and holidays, and during manual pauses (e.g. waiting on customer). Custom hours, workdays, country holidays, DST-aware. Use for support-agent SLA tracking and escalation. (0.001 USDC on Base)
  • POST /v1/parse — Date Math: Parse natural-language dates and relative times like "next Friday at 3pm", "in 2 weeks", "tomorrow morning" or "Dec 25 to Jan 2" into exact ISO datetimes, relative to a reference time and time zone. Use before acting on any date a user typed. (0.001 USDC on Base)
  • POST /v1/overlap — Date Math: Find when working hours overlap across time zones: the best meeting times for a distributed or remote team. Per-participant hours optional; skips weekends by default; up to 14 days. (0.001 USDC on Base)
  • POST /v1/dst — Date Math: Daylight saving time for a time zone: does it observe DST, the year's exact clock changes (UTC instant, local before/after), and whether a local time is valid, skipped (spring-forward gap, e.g. 02:30) or repeated (fall-back, happens twice). Use before scheduling jobs, alarms or meetings near clock changes. (0.001 USDC on Base)
  • POST /v1/market — Date Math: Stock exchange calendar for NYSE/Nasdaq, London (LSE) and Tokyo (JPX): is the market open now, today's session (early closes, lunch break), next open and close, holidays, previous/next trading day, and the trade settlement date (T+1/T+2). Use for trading agents, order timing and settlement. (0.001 USDC on Base)
  • POST /v1/free_slots — Date Math: Find meeting times when everyone is free: intersects each participant's working hours (own time zone, workdays, country holidays) minus their busy blocks, then lists slots of the requested length. Up to 10 people, 14 days, optional buffer between meetings. Use for scheduling across calendars and time zones. (0.001 USDC on Base)
  • POST /v1/stay — Date Math: Rolling stay-limit math such as the Schengen 90/180 rule: days used in the window, days left, overstay check, the longest stay allowed from a planned entry date, and the next date a full stay is possible. Entry and exit days both count. Custom rules via max_days/window_days. Use for travel planning, visa-free stays and "can I enter on". (0.001 USDC on Base)

+26 more endpoints.

First seen · last seen · last active