Sumário
Descrição #
Este passo tem por finalidade realizar uma cotação e obter o valor do par de moedas instantaneamente
Endpoints #
- Produção: https://sbc.bancosemear.com.br/sbc/quotes
Requisição (POST) #
Segue exemplo de requisição:
curl "https://sbc.bancosemear.com.br/sbc/quotes" \
--request POST \
--header "Content-Type: application/json" \
--header 'session=<sessão_login>' \
--data '
{
"currencyPair": "USDBRL",
"expiresIn": 60,
"clientId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"quoteSave": false
}
'
Parâmetros de Requisição #
Cabeçalho #
- Content-Type: Informa ao servidor de que o corpo da requisição possui o formato JSON
- session: Token de autorização obtido no processo de login
Corpo (JSON) #
Propriedade | Descrição | Tipo | Obrigatoriedade |
---|---|---|---|
currencyPair | Par da moeda a ser cotada. Exemplo: USDBRL, EURBRL, GBPBRL | String | Obrigatório |
expiresIn | Validade da cotação em segundos | Int | Obrigatório |
clientId | ID de cliente único (informado pelo Banco Semear no momento do onboarding) | String | Obrigatório |
quoteSave | Indica se a cotação será armazenada no banco de dados para posterior consulta | Bool | Obrigatório |
Resposta #
Segue exemplo de resposta:
{
"clientId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"createdAt": "2025-05-14T18:02:06.309175+00:00",
"currencyPair": "USDBRL",
"expiresIn": 60,
"price": 5.6189,
"quoteId": "85bd77db-aaaa-4f3d-87fe-be8df51f5baa",
"quoteSave": false,
"updatedAt": "2025-05-14T18:02:06.309175+00:00"
}
Parâmetros de Resposta #
Corpo (JSON) #
Propriedade | Descrição | Tipo |
---|---|---|
clientId | ID de cliente único (informado pelo Banco Semear no momento do onboarding) | String |
createdAt | Data de criação da cotação | Datetime |
currencyPair | Par da moeda a ser cotada. Exemplo: USDBRL, EURBRL, GBPBRL | Datetime |
expiresIn | Validade da cotação em segundos | Int |
quoteId | ID único da cotação | String |
quoteSave | Indica se a cotação será armazenada no banco de dados para posterior consulta | Bool |
updatedAt | Data de atualização da cotação | Datetime |