# Requesting a Crypto Quote

## Get Asset List

<mark style="color:blue;">`GET`</mark> `https://live.betaapp.com/asset`

#### Query Parameters

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

#### Headers

| Name                                     | Type   | Description      |
| ---------------------------------------- | ------ | ---------------- |
| accept<mark style="color:red;">\*</mark> | String | application/json |

{% tabs %}
{% tab title="200: OK " %}

```json
{
  "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"
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
  "message": "string"
}
```

{% endtab %}
{% endtabs %}

**Request Example:**

<pre class="language-json" data-overflow="wrap"><code class="lang-json"><strong>curl -X 'GET' \
</strong>  'https://live.betaapp.com/v1/asset' \
  -H 'accept: application/json'
</code></pre>

**Response Example:**

```json
{
  "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

<mark style="color:blue;">`GET`</mark> `https://live.betaapp.com/v1/network/asset/`

#### Query Parameters

| Name                                    | Type   | Description                             |
| --------------------------------------- | ------ | --------------------------------------- |
| asset<mark style="color:red;">\*</mark> | String | Check Crypto coverage for more details. |

#### Headers

| Name                                     | Type   | Description      |
| ---------------------------------------- | ------ | ---------------- |
| accept<mark style="color:red;">\*</mark> | String | application/json |

{% tabs %}
{% tab title="200: OK " %}

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

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
  "message": "string"
}
```

{% endtab %}
{% endtabs %}

**Request Example:**

{% code overflow="wrap" %}

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

{% endcode %}

**Response Example:**

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

## Get the quote for a specific asset&#x20;

<mark style="color:green;">`POST`</mark> `https://live.betaapp.com/v1/quote`

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

#### Headers

| Name                                            | Type   | Description            |
| ----------------------------------------------- | ------ | ---------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer {access\_token} |
| accept<mark style="color:red;">\*</mark>        | String | application/json       |
| Content-Type<mark style="color:red;">\*</mark>  | String | application/json       |

#### Request Body

| Name                                            | Type   | Description                       |
| ----------------------------------------------- | ------ | --------------------------------- |
| network<mark style="color:red;">\*</mark>       | String | Network based on the crypto asset |
| source\_asset<mark style="color:red;">\*</mark> | String | *Asset to be deposited*           |
| target\_asset<mark style="color:red;">\*</mark> | String | *Asset for Settlement*            |
| target\_amount                                  | Number | Amount for Target Asset           |
| product\_id                                     | String | "payments"                        |
| source\_amount                                  | Number | Amount for Source Asset           |

{% tabs %}
{% tab title="200: OK Sucess" %}

```json
{
  "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"
}
```

{% endtab %}

{% tab title="400: Bad Request Error message " %}

```json
{
  "message": "string"
}
```

{% endtab %}
{% endtabs %}

**Request Example:**

{% code overflow="wrap" %}

```json
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"
}'
```

{% endcode %}

{% hint style="warning" %}
When requesting a quote for the **Payments Product**, do not inform **`source_amount`**.
{% endhint %}

**Response Example:**

```json
{
  "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
  }
}
```

{% hint style="info" %}
The **`source_amount_estimate`** is the parameter that returns how much Crypto the payer should deposit.
{% endhint %}

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

<figure><img src="/files/7X3fA5RZXEwn75y56asd" alt=""><figcaption><p>Example of how the Quote being displayed in the front end</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.betaramps.com/documentation-beta-ramps/request-payments/requesting-a-crypto-quote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.