Skip to content

Overview

The Definitive API allows you to programmatically access your trading portfolio data and execute trades via a REST API.

API Keys

Before making requests, you need to generate an API key and secret.

  1. Log into Definitive.
  2. Navigate to your organization page.
  3. Choose which portfolios you want to generate keys for and the permission scope you want (Read-Only vs Read-Write).
  4. Click Generate New Key.
  5. A new key and secret will be generated.
    • The secret is only shown once, please store it securely.
    • If you lose the secret, you will need to generate a new key and secret.

generate key

Authenticating Requests

To maintain security, all requests must be signed and submitted within 2 minutes of signing. The signature must be included in the request headers.

Request Headers

Your authenticated request must include the following headers:

  • x-definitive-api-key: Your API key
  • x-definitive-signature: The request payload signed with your secret.
  • x-definitive-timestamp: The current timestamp.

as well as content type and accept headers, here's an example of a fully formed CURL request:

curl -X GET "https://ddp.definitive.fi/v1/positions?limit=10&offset=0" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -H "User-Agent: Mozilla/5.0" \
     -H "x-definitive-api-key: <key>" \
     -H "x-definitive-signature: <sig>" \
     -H "x-definitive-timestamp: 1741979832595"

Base API URL

All API requests should be made to:

https://ddp.definitive.fi/v1/<endpoint>

Next Steps

In the next section, we'll walk through a sample request.