Skip to main content
Version: mainnet (v0.53)

Using the APIs

Topic: Development

This section is part of a series on the topic of Development.

Docs:

Other resources:

There are a number of ways to interact with Vega through APIs and Ethereum bridge contracts, and below you can learn more about the reference documentation and tutorials that are currently available.

As most of the APIs are designed to use for trading-related queries, the best place to try them out is on the testnet network, also known as Fairground.

Node API endpoints

NameAddressConnectivity
commodum.mainnetcommodum.mainnet.vega.community:3007
greenfield-one.mainnetgreenfield-one.mainnet.vega.community:3007
lovali.mainnetlovali.mainnet.vega.community:3007
nodes-guru.mainnetnodes-guru.mainnet.vega.community:3007
p2p.mainnetp2p.mainnet.vega.community:3007
ryabina.mainnetryabina.mainnet.vega.community:3007
vega.xprv.iogrpc.vega.xprv.io:443
b-harvest.mainnetb-harvest.mainnet.vega.community:3007
figment.mainnetfigment.mainnet.vega.community:3007
nala.mainnetnala.mainnet.vega.community:3007
rockaway.mainnetrockaway.mainnet.vega.community:3007
staking-facilities.mainnetstaking-facilities.mainnet.vega.community:3007
vega-data-chorus.onevega-data-grpc.chorus.one:443

Source: github.com/vegaprotocol/networks
Last refreshed: Fri 4 Nov 2022 17:35:17 UTC

Tutorials

Tutorials provide the information you'll need about the protocol to understand and use the guide, as well as instructions on how to interact with scripts, API calls, or other code.

Tutorials: See the tutorial(s) currently available for this network.

Ethereum bridges

You can also interact with the Ethereum smart contracts, which allow for bridging between Vega and Ethereum.

Smart contracts overview: Start exploring the bridge.

GraphQL

If you’re writing a web app, GraphQL is flexible and allows efficient data retrieval. Like gRPC, GraphQL supports near real time streaming of updates from Vega. It uses websockets under the hood but follows the specification for streaming as set by GraphQL.

GraphQL overview: See what GraphQL covers.

GraphQL playground: Try out GraphQL queries using one of the following playgrounds, hosted by consensus validators.

gRPC

gRPC provides fast and efficient communication with Vega’s APIs. gRPC supports near real time streaming of updates from Vega. gRPC/Protobuf is the transport of choice for many web3 apps.

gRPC: Explore the gRPC reference documentation.

REST

REST is the ubiquitous protocol for the web. Vega has four REST endpoints: two are served by core nodes, and two are served by data nodes. REST is fairly easy to get started with, and Vega supports nearly all the functionality provided by gRPC and GraphQL on the REST APIs. Note: REST does not support streaming.

REST overview: Read more about data and core node APIs.