Getting Started

How to get started with the Vaultoro API.

Getting Your Awesome Vaultoro API Running

Becoming awesome is fairly straight forward process. First you'll need to sign up for a Vaultoro account over on vaultoro.com. That'll take about 20 seconds.

When you're logged in, head over to the settings and create yourself an API token. Make a copy of said token since we'll not be giving that one out again.

You need to append this token to your headers, as so. If you happen to be using curl.

$ curl -H "VTOKEN: $TOKEN" -H 'Content-type: application/json' https://api.vaultoro.com/v1/me

Some endpoints are protected and cannot be accessed with your new API tokens.

If you've done that all right, you should get a response like this.

{
    "data": {
        "countryHandle": "DE",
        "createdAt": 1594306991,
        "defaults": {
            "currency": "EURCENT",
            "pair": "GOLDBTC"
        },
        "email": "[e-mail]",
        "flags": {
            "optInNewsletter": true,
            "verified": true
        },
        "identity": {
            "address": "1 Long Road",
            "city": "Somewhere",
            "firstName": "Simon",
            "lastName": "Awesome",
            "zipCode": "90210"
        },
        "languageHandle": "EN"
    }
}

You should make sure all requests have the application/json header too.

Rate Limiting

All calls are rate limited. If you exceed the limits, you will receive a 429 response and an error message. These are subject to change, please contact support if you have any specific questions.

Requests Using the VTOKEN

100,000 requests per day. Once you've gone over this limit, you will need to wait 24 hours before you can access the API again.

If you flood the API with failed requests using your VTOKEN, you will be throttled for 10 minutes. There's a limit of 100 failed requests in a three hour period.

Requests using public endpoints

10,000 requests per day. You will be blocked for 24 hours if you exceed this limit.

What Next?

Go ahead and learn how to create an order, fetch your history and all that fun stuff.