{
    "schemes": [],
    "swagger": "2.0",
    "info": {
        "description": "TON Validator QOS service to get information about the validator efficiency.\nThe main metric is **efficiency** in percent.",
        "title": "TON Validator QOS",
        "contact": {},
        "version": "1.0"
    },
    "host": "",
    "basePath": "",
    "paths": {
        "/api/qos/cycleScoreboard": {
            "get": {
                "security": [
                    {
                        "APIKeyHeader": []
                    },
                    {
                        "APIKeyQuery": []
                    }
                ],
                "description": "Returns cycle scoreboard by cycle_id or by given timestamp range.",
                "consumes": [
                    "application/json"
                ],
                "produces": [
                    "application/json"
                ],
                "tags": [
                    "default"
                ],
                "summary": "Get cycle scoreboard",
                "operationId": "api_qos_get_cycle_scoreboard",
                "parameters": [
                    {
                        "type": "integer",
                        "description": "Cycle Id",
                        "name": "cycle_id",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "From timestamp",
                        "name": "from_ts",
                        "in": "query"
                    },
                    {
                        "type": "integer",
                        "description": "From timestamp",
                        "name": "to_ts",
                        "in": "query"
                    },
                    {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "collectionFormat": "multi",
                        "description": "Filter by validator adnl",
                        "name": "validator_adnl",
                        "in": "query"
                    },
                    {
                        "type": "boolean",
                        "description": "Query node details",
                        "name": "node_details",
                        "in": "query"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "schema": {
                            "$ref": "#/definitions/CycleScoreboardResponse"
                        }
                    },
                    "500": {
                        "description": "Internal Server Error",
                        "schema": {
                            "$ref": "#/definitions/RequestError"
                        }
                    }
                }
            }
        }
    },
    "definitions": {
        "CycleScoreboardResponse": {
            "type": "object",
            "properties": {
                "scoreboard": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/CycleScoreboardRow"
                    }
                }
            }
        },
        "CycleScoreboardRow": {
            "type": "object",
            "properties": {
                "adnl_addr": {
                    "type": "string"
                },
                "cycle_id": {
                    "type": "integer"
                },
                "efficiency": {
                    "type": "number"
                },
                "efficiency_mc": {
                    "type": "number"
                },
                "efficiency_wc": {
                    "type": "number"
                },
                "geoip_country_iso": {
                    "type": "string"
                },
                "geoip_latitude": {
                    "type": "number"
                },
                "geoip_longitude": {
                    "type": "number"
                },
                "idx": {
                    "type": "integer"
                },
                "pubkey": {
                    "type": "string"
                },
                "pubkey_hash": {
                    "type": "string"
                },
                "quic_ping": {
                    "type": "integer"
                },
                "stake": {
                    "type": "integer"
                },
                "utime_since": {
                    "type": "integer"
                },
                "utime_until": {
                    "type": "integer"
                },
                "validator_adnl": {
                    "type": "string"
                },
                "version_mytonctrl_commit": {
                    "type": "string"
                },
                "version_ton_commit": {
                    "type": "string"
                },
                "wallet": {
                    "type": "string"
                },
                "wallet_version": {
                    "type": "string"
                },
                "weight": {
                    "type": "integer"
                }
            }
        },
        "RequestError": {
            "type": "object",
            "properties": {
                "error": {
                    "type": "string"
                }
            }
        }
    },
    "securityDefinitions": {
        "APIKeyHeader": {
            "type": "apiKey",
            "name": "X-Api-Key",
            "in": "header"
        },
        "APIKeyQuery": {
            "type": "apiKey",
            "name": "api_key",
            "in": "query"
        }
    }
}