Requesting a Crypto Quote

Endpoint to obtain the payment amount in crypto for the Payments Product.

Get Asset List

GET https://live.betaapp.com/asset

Query Parameters

Name	Type	Description
type	String	"fiat" or "crypto"

Headers

Name	Type	Description
accept*	String	application/json

200: OK

{
  "assets": [
    {
      "active": true,
      "id": "string",
      "large_image_url": "string",
      "medium_image_url": "string",
      "name": "string",
      "networks": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "small_image_url": "string",
      "symbol": "string",
      "type": "string"
    }
  ],
  "message": "string"
}

400: Bad Request

{
  "message": "string"
}

Request Example:

curl -X 'GET' \
  'https://live.betaapp.com/v1/asset' \
  -H 'accept: application/json'

Response Example:

{
  "assets": [
    {
      "id": "fc7066e7-669e-4d5e-8f39-a93c4be4df64",
      "name": "Bitcoin",
      "symbol": "BTC",
      "type": "crypto",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/BTC-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/BTC-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/BTC-69.png",
      "networks": [
        {
          "id": "7251cbcb-bb27-4ab1-8213-833205727103",
          "name": "bitcoin"
        }
      ]
    },
    {
      "id": "2f4b229f-3626-458a-9604-db3959d2cb7f",
      "name": "Ethereum",
      "symbol": "ETH",
      "type": "crypto",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/ETH-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/ETH-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/ETH-69.png",
      "networks": [
        {
          "id": "c9921534-4523-4e0c-9745-53228c1c90e4",
          "name": "erc-20"
        }
      ]
    },
    {
      "id": "df16912a-6f7a-493b-a4d7-967a6ccf19d2",
      "name": "Ripple",
      "symbol": "XRP",
      "type": "crypto",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/XRP-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/XRP-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/XRP-69.png",
      "networks": [
        {
          "id": "ad532c74-0aab-480f-ada4-c7e3949a2f2f",
          "name": "ripple"
        }
      ]
    },
    {
      "id": "70b7016d-c2c4-4829-bceb-530fe512446d",
      "name": "USD Tether",
      "symbol": "USDT",
      "type": "crypto",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/USDT-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/USDT-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/USDT-69.png",
      "networks": [
        {
          "id": "3efae459-e2c2-4b0d-9a2f-0ac4cbc68e8b",
          "name": "tron"
        }
      ]
    },
    {
      "id": "3c3152a7-c2da-4ce1-a1b9-2206e7ed07da",
      "name": "Brazilian Real",
      "symbol": "BRL",
      "type": "fiat",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/BRL-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/BRL-20.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/BRL-69.png",
      "networks": null
    },
    {
      "id": "87d859d1-ffb8-4f0c-b53e-47d7059f3f15",
      "name": "United States Dollar",
      "symbol": "USD",
      "type": "fiat",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/USD-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/USD-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/USD-69.png",
      "networks": null
    },
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "Argentine Peso",
      "symbol": "ARS",
      "type": "exotic",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/ARS-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/ARS-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/ARS-69.png",
      "networks": null
    },
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "Colombian Peso",
      "symbol": "COP",
      "type": "exotic",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/COP-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/COP-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/COP-69.png",
      "networks": null
    },
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "Euro",
      "symbol": "EUR",
      "type": "exotic",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/EUR-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/EUR-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/EUR-69.png",
      "networks": null
    },
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "British Pound Sterling",
      "symbol": "GBP",
      "type": "exotic",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/GBP-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/GBP-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/GBP-69.png",
      "networks": null
    },
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "Mexican Peso",
      "symbol": "MXN",
      "type": "exotic",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/MXN-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/MXN-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/MXN-69.png",
      "networks": null
    },
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "CFA Franc BCEAO",
      "symbol": "XOF",
      "type": "exotic",
      "active": true,
      "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/XOF-20.png",
      "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/XOF-35.png",
      "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/XOF-69.png",
      "networks": null
    }
  ]
}

Get Available Networks for an Asset

GET https://live.betaapp.com/v1/network/asset/

Query Parameters

Name	Type	Description
asset*	String	Check Crypto coverage for more details.

Headers

Name	Type	Description
accept*	String	application/json

200: OK

{
  "message": "string",
  "networks": [
    {
      "id": "string",
      "name": "string"
    }
  ]
}

400: Bad Request

{
  "message": "string"
}

Request Example:

curl -X 'GET' \
  'https://live.betaapp.com/v1/network/asset/BTC' \
  -H 'accept: application/json'

Response Example:

{
  "networks": [
    {
      "id": "7251cbcb-bb27-4ab1-8213-833205727103",
      "name": "bitcoin"
    }
  ]
}

Get the quote for a specific asset

POST https://live.betaapp.com/v1/quote

The quote is updated every 20 seconds in our back-end.

Headers

Name	Type	Description
Authorization*	String	Bearer {access_token}
accept*	String	application/json
Content-Type*	String	application/json

Request Body

Name	Type	Description
network*	String	Network based on the crypto asset
source_asset*	String	Asset to be deposited
target_asset*	String	Asset for Settlement
target_amount	Number	Amount for Target Asset
product_id	String	"payments"
source_amount	Number	Amount for Source Asset

200: OK Sucess

{
  "asset": {
    "large_image_url": "string",
    "medium_image_url": "string",
    "name": "string",
    "small_image_url": "string",
    "symbol": "string",
    "type": "string"
  },
  "message": "string",
  "price": {
    "price": 0,
    "symbol": "string"
  },
  "source_amount_estimate": 0,
  "source_asset": "string",
  "target_amount": 0,
  "target_asset": "string"
}

400: Bad Request Error message

{
  "message": "string"
}

Request Example:

curl -X 'POST' \
  'https://live.betaapp.com/v1/quote' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g' \
  -H 'Content-Type: application/json' \
  -d '{
  "network": "bitcoin",
  "product": "payments",
  "source_amount": 0,
  "source_asset": "BTC",
  "target_amount": 500,
  "target_asset": "BRL"
}'

When requesting a quote for the Payments Product, do not inform source_amount.

Response Example:

{
  "source_amount_estimate": 0.002878,
  "source_asset": "BTC",
  "target_amount": 500,
  "target_asset": "BRL",
  "asset": {
    "name": "Bitcoin",
    "type": "crypto",
    "small_image_url": "https://storage.googleapis.com/cryptoassets_images/20px/BTC-20.png",
    "medium_image_url": "https://storage.googleapis.com/cryptoassets_images/35px/BTC-35.png",
    "large_image_url": "https://storage.googleapis.com/cryptoassets_images/69px/BTC-69.png"
  },
  "price": {
    "symbol": "BTCBRL",
    "price": 173712.96
  }
}

The source_amount_estimate is the parameter that returns how much Crypto the payer should deposit.

Here is how the Quote should be displayed on the front end:

Example of how the Quote being displayed in the front end