VirtuaBroker API (1.0.0)

To access the API, you must authenticate using OAuth2.0. The access token can be obtained by making a POST request to the following URL:

https://auth2.virtuabroker.com/realms/cryptobot/protocol/openid-connect/token

Request Details

• Content-Type: application/x-www-form-urlencoded
• Request Body Parameters:
  • client_id: Your client identifier (provided by VirtuaBroker)
  • username: Your account's username (provided by VirtuaBroker)
  • password: Your account's password (provided by VirtuaBroker)
  • grant_type: Use password as the grant type

Upon successful authentication, you will receive an access_token which must be included in the Authorization header as a Bearer token for all subsequent API calls.

Example Code Snippet

Here's a simple example of how to request an access token using Node.js and axios:

import axios from 'axios';
import qs from 'qs';

const authUrl = 'https://auth2.virtuabroker.com/realms/cryptobot/protocol/openid-connect/token';
const clientId = 'your-client-id';
const username = 'your-username';
const password = 'your-password';

const requestToken = async () => {
  const requestBody = qs.stringify({
    client_id: clientId,
    username,
    password,
    grant_type: 'password'
  });

  try {
    const response = await axios.post(authUrl, requestBody, {
      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
    });
    
    const accessToken = response.data.access_token;
    console.log('Access Token:', accessToken);
    return accessToken;
  } catch (error) {
    console.error('Failed to fetch token', error);
    throw error;
  }
};

Integration Testing

For integration purposes, VirtuaBroker provides a staging environment at:

https://api-stage.virtuabroker.com

Here, you can simulate various operations such as deposits and trades. For example, to simulate a deposit and trigger the associated webhook, you can use the following endpoint:

POST https://simulateincomingtransfer-kmygxkfbpq-ew.a.run.app

Request Body Example

{
    "amount": 60,
    "reference": "unique-reference"
}

This will simulate a deposit of 60 units and trigger your configured webhook.

Further Assistance

If you are interested in integrating with the VirtuaBroker platform or need specific credentials for authentication, please contact our support team at daniel@virtuabroker.com. We are here to assist you with any questions or issues you may encounter during the integration process.