Introducing Vega Fairground

What is Fairground?

Fairground is Vega’s testnet. It’s built using the Vega protocol and gives people the chance to test how the protocol works, without using real money. Fairground will also offer the chance to win rewards, based on a running set of bounties (and coming soon - games). Found out more on fairground.wtf. You can see any competitions, how to enter, and the competition leader boards on fairground.wtf.

Note: You don’t need to take part in a bounty or incentivised game to try out Fairground. Download and create a Vega wallet [opens different site], and start trading using Vega Console or the APIs.

We’d like your feedback!

What can you do on Vega right now?

Will the testnet be reset?

The testnet is reset every 14-21 days on Mondays at 10 am GMT (UTC), so all of your positions and collateral will also be cleared and reset. Resets may include new software releases or hotfixes for bugs, and we may need to reset more frequently for essential changes. Please see the community forums or Discord for regular updates on resets and releases.

Note: After each reset, you will need to create and deposit more testnet collateral to be able to trade.

How do the testnet nodes work?

For this version we have two types of nodes, validator nodes and non-validator nodes.

Validator nodes take care of the core trading, and provide a minimal set of APIs. Non-validator nodes provide enriched APIs, which are the ones used to send orders.

How many nodes are there and what are their URLs?

At present all nodes that make up Fairground are run and maintained by Vega. When we open up the network to new participants, this documentation will be updated with requirements, instructions, and a general set of guidelines for bandwidth usage.

Fairground has 20 geo-distributed nodes, made up of 5 validators and 15 non-validators operating specifically for API client use.

  • REST and GraphQL: use https://lb.testnet.vega.xyz to connect to your nearest geographical node
  • gRPC: Connect directly to port 3002 on a node close to you:
    • Europe, Netherlands: n06.testnet.vega.xyz (also n11, n16)
    • Europe, Finland: n07.testnet.vega.xyz (also n12, n17)
    • Asia, Hong Kong: n08.testnet.vega.xyz (also n13, n18)
    • North America, USA (Virginia): n09.testnet.vega.xyz (also n14, n19)
    • Asia, Japan: n10.testnet.vega.xyz (also n15, n20)

What isn’t yet available, and what is likely to change?

Likely to change:

  • The margin calculations are subject to change as we are working on controlling/reducing margin volatility.
  • While automated margin calculation and close-outs are implemented, not all market protections that are described in the protocol whitepaper have been included in the testnet.

Not yet supported or available:

  • Order types like stop orders and trailing stops are not yet available.

What’s to come in future releases?

  • There will be discrete trading via frequent batch auctions along with matched and block trades.
  • Vega Console will be a fully customisable user interface.

What should I do if everything breaks? Where can I report issues?

Thanks in advance for sharing your feedback, it’s an essential part of this process, and will help us get closer to mainnet. You can share your feedback, bug reports, and questions on Vega’s feedback board.

How can I access the APIs and what can I use them for?

See the using Vega’s APIs section for an introduction to the APIs and links to API documentation. We provide REST, GraphQL and gRPC interfaces that can be used to build anything from bots to full trading clients.

How do I request removal of my public/private keys from testnet?

If you have credentials supplied via Vega’s hosted wallet server, and you’d like us to delete any personal information associated with your public key and remove the key pair from the hosted wallet server, please message a Vega team member. Note that your transactions will still exist on the blockchain. If you use the local wallet, then Vega has no access to your login information or details, as it is pseudonymous.

Where does Vega get its prices from?

The prices you see on Vega Fairground are a result of:

  • Users (like you) posting orders and trading
  • Liquidity provision and trading bots, which access market prices on other exchanges and use these to post orders and trade. Depending on the underlying, they get the “real” price every minute to about every 15 minutes.

What are the trading limits?

On this version of Vega Fairground, no trading limits will be enforced.

Are the markets open 24 hours per day, 7 days per week?

Yes, in the initial testnet release markets are open 24/7. In future releases we plan the possibility for the market creator to set opening times.

How much historical price data can I get?

Right now, the amount of historical price data is limited by the amount of time that the testnet has been running (so for a testnet that’s been up for 3 days you can access up to 3 days of tick-by-tick data). You can see it in the chart view in Vega Console, as well as by API.