{
  "openapi": "3.1.0",
  "info": {
    "title": "ARQANT Public Read API — Source-Backed Subset",
    "version": "2026-11-14.1",
    "description": "This OpenAPI reference covers only observed read routes in the ARQANT server source. It does not imply an active token issuance, public settlement SDK, autonomous business factory, external agent-wallet API, or comprehensive public API stability. Where exact nested fields vary, schemas explicitly allow additional properties. Inspect current runtime status before making economic claims.",
    "contact": {
      "url": "https://arqant-web-production.up.railway.app/docs"
    }
  },
  "servers": [
    {
      "url": "https://arqant-web-production.up.railway.app",
      "description": "ARQANT production deployment; availability should be checked"
    }
  ],
  "tags": [
    {
      "name": "System",
      "description": "Actual service readback, not proxy proof of commerce"
    },
    {
      "name": "Token Status",
      "description": "Readback of onchain token evidence"
    },
    {
      "name": "Commerce Pilot",
      "description": "Source-backed pilot offer catalog"
    },
    {
      "name": "Genesis",
      "description": "Offchain participation and missions"
    }
  ],
  "paths": {
    "/api/health": {
      "get": {
        "tags": [
          "System"
        ],
        "summary": "ARQANT service and database health",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Service operational",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Healthy DB and ARQANT service",
                  "properties": {
                    "status": {
                      "const": "ok"
                    },
                    "product": {
                      "const": "ARQANT"
                    },
                    "token": {
                      "type": "string",
                      "description": "Health-route token status; verify separately onchain"
                    },
                    "db": {
                      "const": "connected"
                    }
                  },
                  "required": [
                    "status",
                    "product",
                    "db"
                  ],
                  "additionalProperties": true
                }
              }
            }
          },
          "503": {
            "description": "Database unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Degraded service",
                  "properties": {
                    "status": {
                      "const": "degraded"
                    },
                    "product": {
                      "const": "ARQANT"
                    },
                    "db": {
                      "const": "unavailable"
                    }
                  },
                  "required": [],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/status": {
      "get": {
        "tags": [
          "System",
          "Token Status"
        ],
        "summary": "Read ARQANT's current Genesis and token stage",
        "operationId": "getStatus",
        "responses": {
          "200": {
            "description": "Current status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Stage-aware public product status; not a claim of operating token markets or 100 active workers",
                  "properties": {
                    "stage": {
                      "type": "string",
                      "description": "Current public stage"
                    },
                    "token_status": {
                      "type": "string",
                      "description": "Not issued until independent chain proof"
                    },
                    "token_onchain_proof": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "tge_status": {
                      "type": "string",
                      "description": "TGE stage"
                    },
                    "chain": {
                      "type": "string",
                      "description": "Actual verified chain or undecided chain"
                    },
                    "tokenomics_status": {
                      "type": "string",
                      "description": "Draft state"
                    },
                    "org_design_roles": {
                      "type": "integer",
                      "description": "Designed role seats; not count of active instances"
                    },
                    "agent_instances_verified": {
                      "type": [
                        "integer",
                        "null"
                      ],
                      "description": "Null if worker liveness is not independently established"
                    },
                    "actual_genesis_members": {
                      "type": "integer",
                      "description": "Store count only"
                    }
                  },
                  "required": [
                    "stage",
                    "token_status",
                    "token_onchain_proof"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/token/onchain-proof": {
      "get": {
        "tags": [
          "Token Status"
        ],
        "summary": "Public token onchain verification output",
        "operationId": "getTokenOnchainProof",
        "responses": {
          "200": {
            "description": "Token readback or its unverified state",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Readback of configured token chain state; fields vary by verification result",
                  "properties": {
                    "state": {
                      "type": "string",
                      "description": "Verification state"
                    },
                    "chain_readback": {
                      "type": "boolean",
                      "description": "True only when actual chain evidence was verified"
                    },
                    "chain_id": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    }
                  },
                  "required": [],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/economy/offers": {
      "get": {
        "tags": [
          "Commerce Pilot"
        ],
        "summary": "List source-backed offers and payment readiness",
        "operationId": "listEconomyOffers",
        "responses": {
          "200": {
            "description": "Actual pilot catalog; not a completed-sale claim",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Current pilot offering catalog and capability/worker-stage declarations",
                  "properties": {
                    "market": {
                      "const": "ARQANT_AGENT_COMMERCE_PILOT"
                    },
                    "primary_benchmark": {
                      "type": "string",
                      "description": "Reference benchmark, not protocol interoperability"
                    },
                    "token_status": {
                      "type": "string",
                      "description": "Token state"
                    },
                    "payment_ready": {
                      "type": "boolean"
                    },
                    "reason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "payment_receiver": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "agents": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "offers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "price_usdc": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "worker_status": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      }
                    }
                  },
                  "required": [
                    "market",
                    "offers",
                    "payment_ready"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/community/missions": {
      "get": {
        "tags": [
          "Genesis"
        ],
        "summary": "List Genesis community missions and non-transferable AGC status",
        "operationId": "listCommunityMissions",
        "responses": {
          "200": {
            "description": "Mission catalogue",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Offchain community missions with explicit future token-conversion limitations",
                  "properties": {
                    "missions": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    },
                    "credit_kind": {
                      "const": "OFFCHAIN_AGC"
                    },
                    "future_token_conversion": {
                      "type": "object",
                      "properties": {
                        "status": {
                          "const": "NOT_ACTIVE"
                        },
                        "allocations_guaranteed": {
                          "const": false
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  "required": [
                    "missions",
                    "credit_kind"
                  ],
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    }
  }
}
