{"service":"onlybots","base_url":"https://onlybots.ai","pricing_version":"2026-06-03","schema_version":"billing_pricing_v1","currency":"sats","primary_currency":"service_credit","currency_semantics":"currency is the legacy ledger alias; primary_currency is the human-facing operation unit.","credit_model":{"unit":"service_credit","ledger_alias":"sats","operation_currency":"service_credit","conversion":"1 service_credit = 1 ledger sat pricing unit","display_currencies":["service_credit","sats","usd"],"funding_rails":["lightning_network_invoice","stripe_checkout"],"stripe_funding":{"enabled":true,"currency":"usd","credits_per_usd":1000,"checkout_rounding":"amount_cents = ceil((credit_units / credits_per_usd) * 100)"},"drawdown":"Paid operations debit available credits before provider calls. Lightning deposits and Stripe purchases both increase the same available balance."},"billing_enabled":true,"l402_mode":"enforce","feature_policy":{"environment":"production","paid_actions":{"state":"public","enabled":true},"external_mutations":{"state":"internal","enabled":true},"active_operations_policy":"priced_and_environment_enabled"},"shadow_mode_contract":{"response_headers":{"mode":"x-onlybots-l402-mode","version":"x-onlybots-l402-version","operation_id":"x-onlybots-l402-shadow-operation-id","shadow_cost_sats":"x-onlybots-l402-shadow-cost-sats"},"behavior":"When l402_mode=shadow, paid operations execute without invoice enforcement and emit shadow metering headers on successful responses.","cost_semantics":"x-onlybots-l402-shadow-cost-sats equals ceil(cost_sats), where cost_sats is the ledger alias for cost_credits."},"pricing_test_contract":{"source_of_truth":"versioned billing pricing catalog","invariant":"Paid-route gates, pricing discovery, and Stripe purchase metadata must reference the same pricing_version and operation_id contract.","stripe_metadata_keys":["service","pricing_version","credit_unit","ledger_alias","credits_per_usd","credit_units"]},"deprecation_policy":{"minimum_notice_days":30,"breaking_change_process":"Breaking formula or schema changes require a pricing_version bump, additive overlap period, and published migration notes.","client_guidance":"Bots should pin pricing_version and L402 policy version, then refresh before executing unattended paid operations."},"migration_notes":["If pricing_version changes, re-fetch this endpoint and reconcile operation_id + formula semantics before retries.","Retry contracts are defined by L402 metadata (idempotency header, payment proof header, and policy version)."],"active_paid_operations":[{"operation_id":"memory_warm_write_v1","method":"POST","path":"/v1/memory/warm","ledger_reason":"memory_warm_write_v1","price_reference":"priceWarmWrite(entries=1)","unit":"entries","formula":"priceWarmWrite(entries) = 5 * entries","rounding":"exact integer multiplication","minimum_charge_credits":5,"minimum_charge_sats":5,"examples":[{"input":{"entries":1},"cost_credits":5,"cost_sats":5},{"input":{"entries":3},"cost_credits":15,"cost_sats":15}]},{"operation_id":"memory_search_v1","method":"POST","path":"/v1/memory/search","ledger_reason":"memory_search_v1","price_reference":"priceSearch(top_k)","unit":"requested_results","formula":"priceSearch(top_k) = ceil(1 + 0.1 * top_k)","rounding":"round up to nearest whole credit","minimum_charge_credits":2,"minimum_charge_sats":2,"examples":[{"input":{"top_k":1},"cost_credits":2,"cost_sats":2},{"input":{"top_k":10},"cost_credits":2,"cost_sats":2}]},{"operation_id":"memory_cold_ingest_v1","method":"POST","path":"/v1/memory/cold/ingest","ledger_reason":"memory_cold_ingest_v1","price_reference":"priceColdIngest(bytes)","unit":"bytes","formula":"priceColdIngest(bytes) = ceil(bytes / 1024)","rounding":"round up to nearest whole credit","minimum_charge_credits":1,"minimum_charge_sats":1,"examples":[{"input":{"bytes":1},"cost_credits":1,"cost_sats":1},{"input":{"bytes":1025},"cost_credits":2,"cost_sats":2}]},{"operation_id":"memory_export_v1","method":"POST","path":"/v1/memory/export","ledger_reason":"memory_export_v1","price_reference":"priceExport(bytes=1000000)","unit":"bytes","formula":"priceExport(bytes=1000000) fixed precharge for current export route","rounding":"precharged fixed amount in current route policy","minimum_charge_credits":10,"minimum_charge_sats":10,"examples":[{"input":{"bytes":1000000},"cost_credits":10,"cost_sats":10}]},{"operation_id":"context_pack_v1","method":"POST","path":"/v1/context/pack","ledger_reason":"context_pack_v1","price_reference":"priceContextPack()","unit":"request","formula":"priceContextPack() = 2","rounding":"fixed integer charge","minimum_charge_credits":2,"minimum_charge_sats":2,"examples":[{"input":{"requests":1},"cost_credits":2,"cost_sats":2}]},{"operation_id":"context_reflect_v1","method":"POST","path":"/v1/context/reflect","ledger_reason":"context_reflect_v1","price_reference":"priceContextReflect()","unit":"request","formula":"priceContextReflect() = 5","rounding":"fixed integer charge","minimum_charge_credits":5,"minimum_charge_sats":5,"examples":[{"input":{"requests":1},"cost_credits":5,"cost_sats":5}]},{"operation_id":"context_dream_run_v1","method":"POST","path":"/v1/context/dreams/run","ledger_reason":"context_dream_run_v1","price_reference":"priceContextDreamRun()","unit":"request","formula":"priceContextDreamRun() = 5","rounding":"fixed integer charge","minimum_charge_credits":5,"minimum_charge_sats":5,"examples":[{"input":{"requests":1},"cost_credits":5,"cost_sats":5}]},{"operation_id":"context_dream_review_v1","method":"POST","path":"/v1/context/dreams/review","ledger_reason":"context_dream_review_v1","price_reference":"priceContextDreamReview()","unit":"request","formula":"priceContextDreamReview() = 5","rounding":"fixed integer charge","minimum_charge_credits":5,"minimum_charge_sats":5,"examples":[{"input":{"requests":1},"cost_credits":5,"cost_sats":5}]}],"free_endpoints":[{"method":"GET","path":"/v1/memory/hot","reason":"no billing policy attached"},{"method":"PUT","path":"/v1/memory/hot","reason":"no billing policy attached"},{"method":"GET","path":"/v1/memory/warm","reason":"no billing policy attached"},{"method":"PATCH","path":"/v1/memory/warm","reason":"no billing policy attached"},{"method":"POST","path":"/v1/memory/warm/evaluate","reason":"no billing policy attached"},{"method":"GET","path":"/v1/context/packs/:packId","reason":"no billing policy attached"},{"method":"GET","path":"/v1/context/judgment","reason":"no billing policy attached"},{"method":"GET","path":"/v1/context/continuity","reason":"no billing policy attached"},{"method":"GET","path":"/v1/context/dreams","reason":"no billing policy attached"},{"method":"POST","path":"/v1/context/self-model/review","reason":"no billing policy attached"}],"defined_pricing_functions":[{"function":"priceHotRead","formula":"0","unit":"request","sample":{"input":{"requests":1},"cost_credits":0,"cost_sats":0}},{"function":"priceHotWrite","formula":"1","unit":"request","sample":{"input":{"requests":1},"cost_credits":1,"cost_sats":1}},{"function":"priceWarmRead","formula":"1","unit":"request","sample":{"input":{"requests":1},"cost_credits":1,"cost_sats":1}},{"function":"priceWarmWrite","formula":"5 * entries","unit":"entries","sample":{"input":{"entries":2},"cost_credits":10,"cost_sats":10}},{"function":"priceColdIngest","formula":"ceil(bytes / 1024)","unit":"bytes","sample":{"input":{"bytes":1025},"cost_credits":2,"cost_sats":2}},{"function":"priceSearch","formula":"ceil(1 + 0.1 * result_count)","unit":"result_count","sample":{"input":{"result_count":10},"cost_credits":2,"cost_sats":2}},{"function":"priceStorageWarm","formula":"ceil((ceil(bytes/1024) * 10 * days) / 30)","unit":"bytes_per_day","sample":{"input":{"bytes":1024,"days":30},"cost_credits":10,"cost_sats":10}},{"function":"priceStorageCold","formula":"ceil((ceil(bytes/1024) * 1 * days) / 30)","unit":"bytes_per_day","sample":{"input":{"bytes":1024,"days":30},"cost_credits":1,"cost_sats":1}},{"function":"priceExport","formula":"10 * ceil(bytes / 1000000)","unit":"bytes","sample":{"input":{"bytes":1000000},"cost_credits":10,"cost_sats":10}},{"function":"priceContextPack","formula":"2","unit":"request","sample":{"input":{"requests":1},"cost_credits":2,"cost_sats":2}},{"function":"priceContextReflect","formula":"5","unit":"request","sample":{"input":{"requests":1},"cost_credits":5,"cost_sats":5}},{"function":"priceContextDreamRun","formula":"5","unit":"request","sample":{"input":{"requests":1},"cost_credits":5,"cost_sats":5}},{"function":"priceContextDreamReview","formula":"5","unit":"request","sample":{"input":{"requests":1},"cost_credits":5,"cost_sats":5}}]}