DORRS Data
Login

How to try

Try any DORRS API endpoint right from this documentation using the built-in playground.

Every endpoint page in this Client API section is interactive. You don't need Postman, cURL, or any code to make your first request — each page includes a built-in playground that sends real requests to the DORRS API directly from your browser.

This guide walks you through trying your first endpoint in a few minutes.

Step 1 — Get your API key

DORRS issues API keys as JWT tokens. If you don't have one yet, follow the instructions in Getting Your API Key:

  1. Log in to your DORRS.io account.
  2. Open your account/profile settings.
  3. Copy your Bearer token from the API Keys section.

Your token is a long string starting with eyJhbGciOi... — copy it in full and keep it handy for the next steps.

Getting your API key on DORRS.io

Keep your token secret

Treat your API key like a password. Do not share it or commit it to source code.

Step 2 — Open an endpoint page

Pick any endpoint from the sidebar. If this is your first request, we recommend starting with a read-only endpoint that requires no special permissions, for example Get Symbol List.

Each endpoint page shows:

  • the endpoint description, HTTP method, and path;
  • request parameters and body schema;
  • ready-to-copy code samples (cURL, JavaScript, Python, and more);
  • the interactive playground for sending a test request.

Example of an endpoint page

Step 3 — Insert your API key

Open the playground on the endpoint page and find the Authorization field. Paste your JWT token there.

The token is sent as a standard Bearer header, so the resulting request will include:

Authorization: Bearer <your_jwt_token>

You only need the token itself — the Bearer prefix is added automatically.

Pasting your token into the Authorization field

Step 4 — Fill in parameters and send the request

  1. Fill in the required path/query parameters or the request body, if the endpoint has any. Required fields are marked in the form.
  2. Click Send.
  3. The response — status code and JSON body — appears right below the form.

Example response after sending a request

A 200 OK response with a JSON body means everything works: your key is valid and you are ready to use the API.

If something goes wrong

StatusWhat it meansWhat to do
401 UnauthorizedInvalid or expired tokenRe-copy the token and paste it again, with no extra spaces.
403 ForbiddenYour key has no access to this endpointSome endpoints (e.g., Add Last Sale) are permission-gated. Contact DORRS Admin to request access.
400 Bad RequestInvalid parameters or bodyCheck required fields and value formats against the schema on the page.

The full list of status codes is available in the Overview.

Next steps

Once the playground request succeeds, move the same call into your own code:

On this page