{"service":"AMOS Platform","version":"0.1.0","api_base":"/api/v1","documentation":"https://docs.openclaw.ai","endpoints":[{"group":"Health","description":"Service health and readiness checks","endpoints":[{"method":"GET","path":"/api/v1/health","description":"Liveness check. Returns {status, version}."},{"method":"GET","path":"/api/v1/readiness","description":"Deep readiness check (DB, Redis, Solana). Returns component status."}]},{"group":"Token Economics","description":"AMOS token supply, emission schedule, decay rates, and revenue splits","endpoints":[{"method":"GET","path":"/api/v1/token/stats","description":"Token supply breakdown: total, treasury, entity, investor, community, reserve allocations and emission parameters."},{"method":"GET","path":"/api/v1/token/decay-rate","description":"Current decay rate. Query params: ?revenue_cents=N&costs_cents=N"},{"method":"POST","path":"/api/v1/token/calculate-decay","description":"Calculate token decay for a specific stake context. Body: {tenure_days, current_balance, original_balance, vault_tier, days_inactive}."},{"method":"POST","path":"/api/v1/token/revenue-split","description":"Calculate revenue split. Body: {amount, payment_type: 'usdc'|'amos'}."},{"method":"GET","path":"/api/v1/token/emission","description":"Daily emission amount. Query params: ?day_index=N (0 = genesis)."}]},{"group":"Governance","description":"On-chain governance proposals, voting, and quality gates","endpoints":[{"method":"GET","path":"/api/v1/governance/proposals","description":"List all governance proposals with vote tallies."},{"method":"POST","path":"/api/v1/governance/proposals","description":"Create a proposal. Body: {title, description, proposer_wallet, proposal_type: 'feature'|'parameter'|'treasury'|'research'}. Requires minimum stake.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/governance/proposals/{id}","description":"Get proposal detail including votes. Replace {id} with a UUID."},{"method":"POST","path":"/api/v1/governance/proposals/{id}/vote","description":"Cast a vote. Body: {voter_wallet, support: true|false}. Weight derived from on-chain stake.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/governance/proposals/{id}/gates","description":"Quality gate status for a proposal (benchmark, A/B test, feedback, steward approval)."}]},{"group":"Billing","description":"Customer management, subscriptions, usage metering, and pricing","endpoints":[{"method":"GET","path":"/api/v1/billing/customers","description":"List all customers.","auth":"Bearer token"},{"method":"POST","path":"/api/v1/billing/customers","description":"Create a customer. Body: {name, email, organization?, plan?: 'free'|'hosted'}. Returns API key.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/billing/customers/{id}","description":"Get customer detail. Replace {id} with a UUID.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/billing/customers/{id}/usage","description":"Get usage metrics for a customer in the current billing period.","auth":"Bearer token"},{"method":"POST","path":"/api/v1/billing/customers/{id}/subscribe","description":"Subscribe a customer to a plan. Body: {plan: 'free'|'hosted', payment_method_id?}.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/billing/plans","description":"List available subscription plans with pricing and limits."},{"method":"GET","path":"/api/v1/billing/usage","description":"Get aggregated usage for the authenticated customer.","auth":"Bearer token"},{"method":"POST","path":"/api/v1/billing/calculate","description":"Calculate billing for compute usage records. Body: {customer_id, compute_records: [{model_name, input_tokens, output_tokens}], pay_with_amos}.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/billing/pricing","description":"Get model pricing, markup percentage, and AMOS discount percentage."}]},{"group":"Provisioning","description":"Harness container lifecycle: provision, start, stop, deprovision","endpoints":[{"method":"POST","path":"/api/v1/provision/harness","description":"Provision a new harness container. Body: {customer_id, region?, instance_size?: 'small'|'medium'|'large', environment?, env_vars?}. Requires Docker.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/provision/harness/{id}","description":"Get harness container status. Replace {id} with the container ID.","auth":"Bearer token"},{"method":"POST","path":"/api/v1/provision/harness/{id}/start","description":"Start a stopped harness container.","auth":"Bearer token"},{"method":"POST","path":"/api/v1/provision/harness/{id}/stop","description":"Stop a running harness container.","auth":"Bearer token"},{"method":"DELETE","path":"/api/v1/provision/harness/{id}","description":"Deprovision (remove) a harness container permanently.","auth":"Bearer token"},{"method":"GET","path":"/api/v1/provision/harness/{id}/logs","description":"Retrieve recent logs from a harness container.","auth":"Bearer token"}]},{"group":"Sync","description":"Harness-to-platform sync: heartbeat, config, activity reporting, versioning","endpoints":[{"method":"POST","path":"/api/v1/sync/heartbeat","description":"Report harness heartbeat. Body: {harness_version, deployment_mode, uptime_secs, healthy, timestamp}.","auth":"X-Harness-Token"},{"method":"GET","path":"/api/v1/sync/config","description":"Fetch remote config for a harness. Query params: ?version=x.y.z","auth":"X-Harness-Token"},{"method":"POST","path":"/api/v1/sync/activity","description":"Report usage activity. Body: {period_start, period_end, conversations, messages, tokens_input, tokens_output, tools_executed, models_used, timestamp}.","auth":"X-Harness-Token"},{"method":"GET","path":"/api/v1/sync/version","description":"Get latest harness version info and whether an update is required."}]}]}