Requesting a Quote

Obtain a quote for buying and selling crypto.

Get Asset List

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

Query Parameters

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

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"
        }
      ]
    }
  ]
}

Get Available Networks for an Asset

GET https://live.betaapp.com/network/asset/{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 or when the user changes the asset parameters.

Headers

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

Request Body

Name	Type	Description
source_asset*	String	Asset that user wants to provide in the transaction. It could be any Fiat or Crypto.
target_asset*	String	Asset that user wants to receive in the transaction. It could be any supported Fiat or Crypto.
target_amount	Number	Amount to be delivered
source_amount	String	Amount to be collected
network*	String	Crypto network of the transaction
product*	String	"exchange"

200: OK Sucess

{
  "asset": {
    "name": "string",
    "medium_image_url": "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": "exchange",
  "source_amount": 1,
  "source_asset": "BTC",
  "target_amount": 0,
  "target_asset": "MXN"
}'

Response Example:

{
  "target_amount_estimate": 627271.28,
  "source_asset": "BTC",
  "source_amount": 1,
  "target_asset": "MXN",
  "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": "BTCMXN",
    "price": 627271.28
  }
}

You may receive target_amount_estimate or source_amount_estimatewhen requesting quote. If the user provides values for the Source Asset, Beta will provide a quote for the Target asset, and vice versa.