Pular para o conteúdo principal
Get a Quote
curl --request GET \
  --url https://api.spherepay.co/v2/quote/{id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.spherepay.co/v2/quote/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.spherepay.co/v2/quote/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.spherepay.co/v2/quote/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.spherepay.co/v2/quote/{id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.spherepay.co/v2/quote/{id}")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.spherepay.co/v2/quote/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "id": "quote_d243ab2b1de4447d8a046d87fefe58cf",
  "status": "active",
  "type": "off_ramp",
  "customerId": "customer_d243ab2b1de4447d8a046d87fefe58cf",
  "fees": {
    "integratorFee": {
      "fixedAmount": "0.00",
      "bpsRate": "0",
      "totalAmount": "0.00",
      "currency": "usdc"
    },
    "platformFee": {
      "fixedAmount": "0.00",
      "bpsRate": "20",
      "totalAmount": "2.00",
      "currency": "usdc"
    }
  },
  "source": {
    "currency": "usdc",
    "network": "polygon",
    "amount": "100.00"
  },
  "destination": {
    "currency": "brl",
    "network": "pix",
    "amount": "545.50",
    "exchangeRate": "5.455"
  },
  "expiresAt": "2025-01-01T00:01:00.000Z",
  "created": "2025-01-01T00:00:00.000Z",
  "updated": "2025-01-01T00:00:30.000Z"
}
{
"status": 400,
"detail": "Invalid request parameters",
"code": "address/invalid",
"correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}
{
"status": 404,
"detail": "Resource not found",
"code": "resource/not-found",
"correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}
{
"status": 422,
"detail": "Validation failed",
"code": "validation/failed",
"correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
"errors": [
{
"detail": "Invalid email format",
"pointer": "/email"
},
{
"detail": "Name is required",
"pointer": "/name"
}
]
}
Busque o estado atual de uma única cotação. Útil ao consultar mudanças de status (activeused ou activeexpired) antes de acionar lógica downstream na sua aplicação.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

id
string
obrigatório

The unique quote ID.

Pattern: ^quote_[a-z0-9]+$
Exemplo:

"quote_d243ab2b1de4447d8a046d87fefe58cf"

Resposta

id
string
obrigatório

A unique identifier for the quote.

Pattern: ^quote_[a-z0-9]+$
Exemplo:

"quote_d243ab2b1de4447d8a046d87fefe58cf"

status
enum<string>
obrigatório

The current status of the quote.

Opções disponíveis:
active,
used,
expired
Exemplo:

"active"

type
enum<string>
obrigatório

The transfer type this quote is for.

Opções disponíveis:
on_ramp,
off_ramp
Exemplo:

"off_ramp"

customerId
string
obrigatório

The customer ID.

Exemplo:

"customer_d243ab2b1de4447d8a046d87fefe58cf"

fees
object
obrigatório
source
object
obrigatório
destination
object
obrigatório
expiresAt
string<date-time>
obrigatório

The datetime when this quote expires.

Exemplo:

"2025-01-01T00:01:00.000Z"

created
string<date-time>
obrigatório

The datetime the quote was created.

Exemplo:

"2025-01-01T00:00:00.000Z"

updated
string<date-time>
obrigatório

The datetime the quote was last updated.

Exemplo:

"2025-01-01T00:00:30.000Z"

Última modificação em 22 de junho de 2026