Get a BRE-B quote

Cached USD→COP rate (default 6 hours) plus the fee stack. Omit destinationCop to receive only the effective rate. Amounts below 4000 COP or 2 USDC to Bridge return below_minimum.

GET /api/integrations/breb/quote

Get a BRE-B quote

cURL

curl --request GET \
  --url http://localhost:3000/api/integrations/breb/quote \
  --header 'Authorization: Bearer <token>'

200

{
  "quoteId": "q_11111111-1111-1111-1111-111111111111",
  "fromToken": "USDC",
  "destinationCop": "10000",
  "effectiveUsdCop": "3902",
  "display": "1 USD = 3902 COP",
  "sourceAmount": "2563065",
  "sourceAmountUsd": "2.563065",
  "netUsdcToBridge": "2.537688",
  "sellRate": "4000",
  "swapProvider": "none",
  "cached": false,
  "expiresAt": "2026-09-18T22:00:00.000Z",
  "fees": [
    {
      "code": "bridge_fx",
      "amountUsd": "0.03",
      "to": null,
      "status": "quoted"
    },
    {
      "code": "bridge",
      "amountUsd": "0.01",
      "to": null,
      "status": "quoted"
    },
    {
      "code": "copby",
      "amountUsd": "0.03",
      "to": "0x1111111111111111111111111111111111111111",
      "status": "quoted"
    }
  ]
}

Authorizations

Authorization · string · header · required

Integration API key. Send as Bearer copby_live_pk_….

Query Parameters

destinationCop · string

Integer COP to deliver. Optional; omitted returns rate only.

Example:

"10000"

fromToken · enum<string> · default: USDC

Available options: USDC, COPm

userAddress · string

Used when quoting COPm so the swap route can be built

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0x2222222222222222222222222222222222222222"

Response

200

application/json

Quote

quoteId · string

fromToken · enum<string>

Available options: USDC, COPm

destinationCop · string | null

effectiveUsdCop · string

display · string

Example:

"1 USD = 3902 COP"

sourceAmount · string | null

Atomic units of fromToken

sourceAmountUsd · string | null

netUsdcToBridge · string | null

sellRate · string

swapProvider · enum<string> | null

Available options: none, squid, uniswap_v3, mock, null

cached · boolean

expiresAt · string<date-time>

fees · object[]

Hide child attributes

fees. code · enum<string>

Available options: swap, bridge_fx, bridge, copby

fees. amountUsd · string

fees. to · string | null

fees. status · enum<string>

Available options: quoted, verified, pending