The Graph API

The Graph API provides detailed information about various financial activities. With the use of this API, you can retrieve data about open interests, deposits, withdraws, open positions, open orders, portfolios, closed positions, and trade activities.

Base URL

The base URL for all the API endpoints is https://api.vela.exchange/graph. Example Request Base:

GET https://api.vela.exchange/graph/{ENDPOINT}/{chainId}/{address}

API Endpoints

This endpoint retrieves open interests for a given chain id.

get

/graph/open_interests/{chainId}

Path parameters

chainIdstringrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/open_interests/{chainId}'

200

200

No body

This endpoint retrieves deposits for a given chain id and address.

get

/graph/deposits/{chainId}//{address}

Path parameters

chainIdstringrequired

addressstringrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/deposits/{chainId}/{address}'

200

200

No body

This endpoint retrieves withdraws for a given chain id and address.

get

/graph/withdraws/{chainId}//{address}

Path parameters

chainIdstringrequired

addressstringrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/withdraws/{chainId}/{address}'

200

200

No body

This endpoint retrieves open positions for a given chain id and address.

get

/graph/open_positions/{chainId}//{address}

Path parameters

chainIdstringrequired

addressstringrequired

Query parameters

paginatenumberrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/open_positions/{chainId}/{address}?paginate=1'

200

200

No body

This endpoint retrieves open positions for a given chain id and address.

get

/graph/open_orders/{chainId}//{address}

Path parameters

chainIdstringrequired

addressstringrequired

Query parameters

paginatenumberrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/open_orders/{chainId}/{address}?paginate=1'

200

200

No body

This endpoint retrieves portfolios for a given chain id and address.

get

/graph/portfolios/{chainId}//{address}

Path parameters

chainIdstringrequired

addressstringrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/portfolios/{chainId}/{address}'

200

200

No body

This endpoint retrieves closed positions for a given chain id and address.

get

/graph/closed_positions/{chainId}//{address}

Path parameters

chainIdstringrequired

addressstringrequired

Query parameters

paginatenumberrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/closed_positions/{chainId}/{address}?paginate=1'

200

200

No body

This endpoint retrieves trade activities for a given chain id and address.

get

/graph/trade_activities/{chainId}//{address}

Path parameters

chainIdstringrequired

addressstringrequired

Query parameters

paginatenumberrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.vela.exchange/graph/trade_activities/{chainId}/{address}?paginate=1'

200

200

No body

An example of a request:

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api.vela.exchange/graph/deposits/42161/0xYourEthereumAddress',  // Update with your chainId and address
  headers: { }
};

axios(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Errors

Our API uses conventional HTTP response codes to indicate success or failure of an API request. In general, 2xx indicates success, 4xx indicates an error from the client's side, and 5xx indicates an error from the server's side.