Account session

Session tokens are best for frontend applications where you need to authenticate users in the browser. Sessions are created by your backend using the project API key, then passed to the client. Sessions expire after a period of inactivity but can be refreshed.

Name	Type	Required	Description
`Authorization`	string	Yes	Bearer token format: `Bearer <session_token>`

Flow

Backend creates a session

Your server calls the session endpoint using the project API key.

Pass token to client

Return the session token to the frontend (e.g., via HTTP-only cookie or secure storage).

Client makes requests

The frontend sends the token in the Authorization header with each request.

Step 1: Create a session

This is called from your backend using the project API key.

curl -X POST "https://synthesis.trade/api/v1/project/account/{account_id}/session" \
  -H "X-PROJECT-API-KEY: sk_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345678901234="

{
    "success": true,
    "response": {
        "account_id": "01234567-89ab-cdef-0123-456789abcdef",
        "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "created_at": "2026-01-01T00:00:00",
        "expires_at": "2026-01-08T00:00:00"
    }
}

Step 2: Use the session token

Pass the token from the response as a Bearer token in your client requests.

curl -X GET "https://synthesis.trade/api/v1/wallets" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Refresh a session

Expire the existing session and issue a new one. This extends the user’s authenticated session without requiring them to re-authenticate.

curl -X POST "https://synthesis.trade/api/v1/project/account/{account_id}/session/{session_id}/refresh" \
  -H "X-PROJECT-API-KEY: sk_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345678901234="

{
    "success": true,
    "response": {
        "account_id": "01234567-89ab-cdef-0123-456789abcdef",
        "session_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "created_at": "2026-01-01T00:00:00",
        "expires_at": "2026-01-08T00:00:00"
    }
}

Expire a session

Manually expire a specific session or all sessions for an account.

curl -X POST "https://synthesis.trade/api/v1/project/account/{account_id}/session/{session_id}/expire" \
  -H "X-PROJECT-API-KEY: sk_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345678901234="

curl -X POST "https://synthesis.trade/api/v1/project/account/{account_id}/sessions/expire-all" \
  -H "X-PROJECT-API-KEY: sk_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345678901234="

Available routes

All routes under /api/v1/account/* and /api/v1/wallet/* accept session tokens.

Route	Method	Description
`/api/v1/account/session`	`GET`	Get current session info
`/api/v1/wallets`	`GET`	List wallets
`/api/v1/wallet/pol/{id}/order`	`POST`	Place an order
`/api/v1/wallet/pol/{id}/balance`	`GET`	Get wallet balance
`/api/v1/wallet/pol/{id}/positions`	`GET`	Get positions
…		All wallet and account endpoints

Overview

Getting Started

Authentication

Real-time Data

Header

Flow

Step 1: Create a session

Step 2: Use the session token

Refresh a session

Expire a session

Available routes

​Header

​Flow

​Step 1: Create a session

​Step 2: Use the session token

​Refresh a session

​Expire a session

​Available routes

Header

Flow

Step 1: Create a session

Step 2: Use the session token

Refresh a session

Expire a session

Available routes