Using the Postman workspace 📮

blog photo
Joanne SnelDecember 8, 2021

An easy way to test out the API is by using Postman, a platform that allows you to make API calls right within your browser or desktop app. This way, before you get to building your brokerage product, you’ll know exactly what’s possible. We’ve set up a Postman workspace that can be used to familiarise yourself with the endpoints that we offer in our Market Data and Trading APIs. You’ll see just how simple it is to, for example, place a trade with (hint: it’s just one API call).

Title Card for the Article "Using the Postman workspace"

Why Postman? 📯

Postman is an easy-to-use application that allows you to test out an API without having to manually set up a testing environment. It’s as simple as filling in a request URL, providing the proper authorisation and inputting the relevant query/request body parameters. Luckily for you, we’ve already set up a Postman workspace with all requests included, all you need to do is fork it, fill in your API key and start sending requests.

Using Postman 👨 

The Postman workspace can be found here. For personal use, you need to import the workspace into your own Postman account. Let’s see how that’s done!

Forking the workspace 🍴

We’re assuming you already have a Postman account, but if you don’t, you can easily set one up, here. Because the workspace is public, you need to fork it into your own workspace to be able to send requests

Create a fork from our Working Space

To fork our workspace, click the ‘…’ next to the collection of your choice and select ‘Create a fork’.

You’ll be prompted to give the fork a name and select a workspace to copy it into. You can choose to create a separate workspace, or simply copy it into the default ‘My Workspace’. 

To make requests, you’ll need to set up several environment variables — we’ve also set up a template for this (which you can also fork in the same way).

Environment Template

The environment templates can be found under the conveniently named ‘Environments’ tab on the left-hand side.

You’ll notice that we’ve provided a template for Paper Money Trading and Real Money Trading, select the one that suits your needs. Make sure that you fork the environment into the same workspace as your forked collection. 

Configuring the environment 🌳 

To set-up your environment, you’ll want to fill in your API key(this can be found on your dashboard). Because your workspace is only accessible to you, it doesn’t matter whether you fill it in under ‘Initial Value’ or ‘Current Value’, but as a best practice, you should always fill in sensitive information under ‘Current Value’. This prevents the information from being synced with the Postman workspace (especially important if you’re working in a (semi-)public workspace).

You’ll know you’re in your forked workspace due to the Ψ next to the environment name — notice I’ve called my fork ‘lemon_tutorial’.

Make sure you save any changes (upper right-hand corner) and set the environment active, you can do this by hovering over its name and clicking the check-mark, which should become grey upon success. 

If you’ve properly set up your API key and environment, the environment should appear in the upper right-hand corner (as can be seen in the screenshot below). Additionally, if you navigate to the authorisation tab for either Collection, hovering over {{API-KEY}} should display the key you’ve filled in. 

If you can’t see your API key upon hovering, ensure that your environment has been saved and set active (you might need to manually select it in the upper right-hand corner if you have more than one environment).

Making your first request ❓

Let’s begin by searching for a stock — for example, Coinbase. Navigate to the ‘Instruments’ folder in the Historical Market Data API collection. Here, you have the option to retrieve an instrument with its ISIN, MIC or simply with its title.

The API response can be found in the console below after clicking the blue ‘Send’ button. In the screenshot, we can see that, on the Munich Stock Exchange, the ticker for Coinbase is 1QZ.

You can also specify other query parameters in your request. In this case, you can choose to retrieve an instrument based on its type, what currency it is listed in and/or whether it is currently tradable. All you need to do is toggle the parameter key, fill in a value and run the request again. More on that in the next section. 👇

Other important considerations 🤔

To get the most of the workspace, we recommend you read the following tips:

Some endpoints, for example the /ohlc/ endpoint in our Historical Market Data API, have mandatory query parameters. For all query parameters that are required, we’ve configured the workspace to automatically toggle that parameter (indicated by the checked box). But, whether it is optional or required can also be found in the key-value description. In addition, some requests also require path variables as input — these are listed below any query parameters (they can also be recognised in the request URL by a ‘:’). If specified, these are always required.

Note that ‘isin’ is the only required query parameter for this endpoint, we also need to specify the path variable ‘x1’ in order to send this request.

Other endpoints require a request body, you’ll recognise this by the green dots next to the headers underneath the request URL. For example, for the /orders/ endpoint in our Trading API, you’ll notice the green dot next to ‘Body’, this means that we need to fill in information here. Notice that there’s a lot of required variables here! I’ve filled in some example values below.

In the above screenshot, you’ll see I placed a buy order for 2 shares of Coinbase.

All other requests follow a similar format — some require you to fill in both ‘Params’ and ‘Body’ variables. Keep an eye out for those green dots!

You’re ready to explore on your own! How about you try placing and activating a trade? And then having a look at your position? Have a look at our documentation to see what’s possible. 

Over to you! 🤝

We want to know how we can make this collection better! If there’s any improvements that come to mind, do not hesitate to reach out to us through Twitter, Instagram or Slack. And remember, if you haven’t signed up to yet, do that now to kickstart your automated trading journey. 

Joanne from🍋

You might also be interested in

blog photo

Using Time Series Forecasting to predict stock prices 🔮

In this article you will learn what time series forecasting is and how its application in finance looks like. Then you'll also dive into Facebook's Prophet Model for Time Series Forecasting and use it together with the Market Data API to forecast the development of the Tesla Stock.

blog photo

Dummies Guide to Trading with Machine Learning

Ever wonder how a trader with decades of experience on thousands of stocks and lightning fast reaction times might perform in the market? With some machine learning knowledge, you might be able to automate such a trader yourself! 💻 📈

blog photo

4 reasons why YOU should automate your trading strategy

In the current volatile market conditions, everyone is trying to find ways to minimise portfolio loss. In that context, have you ever thought about automating your trading strategy? In this article, we will dive into 4 reasons for doing so. Expect to learn how it can save you time, make your trading more efficient and lead to data-based decisions.

Dive Deeper

Find more resources to get started easily

Check out our documentation to find out more about our API structure, different endpoints and specific use cases.


Join community

Join our Slack channel to actively participate in our community, ask questions to other users and stay up to date at all times.


Interested in building with us?

We are always looking for great additions to our team that help us build a brokerage infrastructure for the 21st century.

Need any help?
Ask a question in our CommunityAsk a question in our CommunityGet started with our DocumentationGet started with our DocumentationGet inspired on our BlogGet inspired on our Blog
© 2023Privacy PolicyImprint
Systems are down

As a tied agent under § 3 Sec. 2 WplG on the account and under the liability of DonauCapital Wertpapier GmbH, Passauer Str. 5, 94161 Ruderting (short: DonauCapital), GmbH offers you the receipt and transmission of orders for clients (§ 2 Sec. 2 Nr. 3 WpIG) of financial instruments according to § 2 Sec. 5 WpIG as well as brokerage of accounts.