{
  "components": {
    "schemas": {
      "Erro": {
        "properties": {
          "erro": {
            "type": "string"
          },
          "mensagem": {
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "chave": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Cotação de qualquer par de moedas (ex.: USD-BRL, EUR-BRL, BTC-USD), renovada no máximo a cada 30 minutos. Autenticação por chave Bearer, gerada no console (APIs).",
    "title": "API de Cotação de Moedas",
    "version": "1.0.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/v1/cotacoes": {
      "get": {
        "parameters": [
          {
            "description": "Pares ORIGEM-DESTINO separados por vírgula, de 1 a 10 (ex.: USD-BRL,EUR-BRL).",
            "in": "query",
            "name": "pares",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "cotacoes": [
                    {
                      "par": "EUR-BRL",
                      "origem": "EUR",
                      "destino": "BRL",
                      "nome": "Euro/Real Brasileiro",
                      "compra": 6.4983,
                      "venda": 6.5003,
                      "maxima": 6.5309,
                      "minima": 6.4449,
                      "variacao": 0.0444,
                      "variacao_pct": 0.687958,
                      "cotado_em": "2026-11-19 18:16:46"
                    }
                  ],
                  "atualizado_em": "2026-11-19T21:32:20Z",
                  "desatualizado": false
                },
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Sucesso"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          }
        },
        "summary": "Cotação de pares de moedas"
      }
    },
    "/v1/cotacoes/pares": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "pares": [
                    {
                      "par": "BTC-BRL",
                      "nome": "Bitcoin/Real Brasileiro"
                    },
                    {
                      "par": "EUR-BRL",
                      "nome": "Euro/Real Brasileiro"
                    },
                    {
                      "par": "USD-BRL",
                      "nome": "Dólar Americano/Real Brasileiro"
                    }
                  ],
                  "atualizado_em": "2026-11-19T00:05:11Z",
                  "desatualizado": false
                },
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Sucesso"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          }
        },
        "summary": "Pares de moedas disponíveis"
      }
    },
    "/v1/cotacoes/sessao": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "nome": "Meu site",
                  "plano": "Cotações 5.000",
                  "estado": "criada",
                  "valido_ate": "2026-12-19T14:30:00Z",
                  "limite_diario": 5000,
                  "limite_por_minuto": 60
                },
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Sucesso"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          }
        },
        "summary": "Dados da sessão e do plano"
      }
    },
    "/v1/cotacoes/uso": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "data": "2026-11-19",
                  "consultas_hoje": 128,
                  "consultas_no_mes": 2410,
                  "limite_diario": 5000,
                  "restante_hoje": 4872
                },
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "Sucesso"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            },
            "description": "Erro"
          }
        },
        "summary": "Consultas feitas hoje e no mês"
      }
    }
  },
  "security": [
    {
      "chave": []
    }
  ],
  "servers": [
    {
      "url": "https://dev-api.primux.cloud"
    }
  ]
}