Arkham 1.0 · API Documentation

Dynamic yield pricing fundamentals

Arkham 1.0 is the Kryptur console and same-origin REST proxy for Dynamic Yield Pricing — a real-time equipment rental pricing engine that applies airline- and hotel-style revenue management to laser cleaning fleets. Quotes, bookings, and tracking stay consistent across customer and internal ops surfaces.

Fundamentals

Yield-aware rates

Reinforcement learning elasticity, stochastic dynamic programming contracts, and spot auctions clear market rates from live utilization — projecting +29.6% annual revenue lift versus static hourly pricing.

Quote → reserve

POST /pricing/quote returns a time-limited offer (~120s TTL). Selected machines become reserved so concurrent customers cannot double-book the same units.

Confirm → in use

POST /booking/confirm locks the quote into a booking. Machines move to in_use and delivery ETA tracking begins for the chosen job site.

Track → release

GET /booking/{id}/track streams status and coordinates. POST /booking/{id}/complete returns machines to available for the next quote.

Authentication

Requests to /api/arkham/* forward to the Arkham FastAPI backend. Demo deployments accept unauthenticated calls; production partner apps may send x-api-key or Bearer tokens when keys are enabled.

curl https://www.kryptur.com/api/arkham/health

REST endpoints

Proxy base: /api/arkham — all paths below are relative to the Kryptur origin.

MethodPathSummary
GET/api/arkham/healthService liveness plus fleet summary (available / reserved / in-use).
GET/api/arkham/fleet/machinesList laser cleaning units with status, base rate, and depot metadata.
GET/api/arkham/fleet/locationsIE / GB / EU country catalog with currency and pin labels.
GET/api/arkham/fleet/plansSubscription plans, min hourly USD, and FX table.
GET/api/arkham/fleet/summaryFleet counts and utilization for surge-aware pricing.
POST/api/arkham/fleet/machines/{id}/releasePartner ops: force-release a reserved or in-use unit.
POST/api/arkham/pricing/quoteMulti-machine quote — requires country, city, pin_eircode; short TTL; selected units become reserved.
POST/api/arkham/booking/confirmConfirm a quote — machines move to in_use and ETA tracking starts.
GET/api/arkham/booking/{id}/trackLive delivery status, coordinates, and ETA until delivered.
POST/api/arkham/booking/{id}/completeEnd rental and release machines back to available.
GET/api/arkham/bookingsPartner / internal booking ledger for ops release controls.

Live console workspaces

  • Workspaces — entry cards for customer booking, internal ops, and API docs.
  • Customer booking — multi-select fleet, location, timing, quote, confirm, and track.
  • Internal ops — utilization board, fleet table, and booking release controls.
  • API docs — endpoint reference plus program and business process diagrams.
Launch console