{
 "openapi": "3.1.0",
 "info": {
  "title": "SAIKYO public API",
  "version": "1.0.0",
  "description": "Read-only data from SAIKYO: USDT/RUB rate, Omega Wallet foreign Visa terms, how to pay for foreign services from Russia, travel card tips by country, Saikyo Shop search. Rates are indicative; final terms are shown before payment.",
  "termsOfService": "https://saikyo.exchange/en/rules",
  "contact": {
   "name": "SAIKYO",
   "url": "https://saikyo.exchange/en/mcp-server"
  }
 },
 "servers": [
  {
   "url": "https://saikyo.exchange"
  }
 ],
 "paths": {
  "/api/public/usdt-rub": {
   "get": {
    "operationId": "getUsdtRubRate",
    "summary": "Current USDT/RUB rate (buy via SBP QR) and market reference",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true
        }
       }
      }
     }
    }
   }
  },
  "/api/public/card-terms": {
   "get": {
    "operationId": "getForeignCardTerms",
    "summary": "Omega Wallet virtual Visa terms for residents of Russia",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true
        }
       }
      }
     }
    }
   }
  },
  "/api/public/how-to-pay": {
   "get": {
    "operationId": "howToPayFromRussia",
    "summary": "Payment options from Russia for a foreign service",
    "parameters": [
     {
      "name": "service",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Service name, e.g. Claude, Steam"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "en",
        "ru"
       ],
       "default": "en"
      },
      "description": "Language of links and titles"
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true
        }
       }
      }
     }
    }
   }
  },
  "/api/public/travel-card": {
   "get": {
    "operationId": "travelCardForCountry",
    "summary": "Card payment tips for travel to a country; omit country to list all",
    "parameters": [
     {
      "name": "country",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Country name, e.g. Turkey"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "en",
        "ru"
       ],
       "default": "en"
      },
      "description": "Language of links and titles"
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true
        }
       }
      }
     }
    }
   }
  },
  "/api/public/shop": {
   "get": {
    "operationId": "searchSaikyoShop",
    "summary": "Search Saikyo Shop digital goods priced in rubles",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Product or brand, e.g. ChatGPT Plus"
     },
     {
      "name": "category",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Category id, e.g. ai"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "en",
        "ru"
       ],
       "default": "en"
      },
      "description": "Language of links and titles"
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true
        }
       }
      }
     }
    }
   }
  },
  "/api/public/payment-passport": {
   "get": {
    "operationId": "getPaymentPassport",
    "summary": "Payment facts of a foreign service from official pages: payment methods, Russia availability, gift cards, crypto, sources",
    "parameters": [
     {
      "name": "service",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Service name, e.g. Notion or Vultr; omit for dataset links"
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "en",
        "ru"
       ],
       "default": "en"
      },
      "description": "Language of links"
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true
        }
       }
      }
     }
    }
   }
  }
 }
}