Import Lighter Credentials

curl --request POST \
  --url https://api.tide.ag/api/trading/lighter/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletIdOrAddress": "0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996",
  "accountIndex": 0,
  "apiKeyIndex": 10,
  "apiPublicKey": "0x...",
  "apiPrivateKey": "0x..."
}
'

import requests

url = "https://api.tide.ag/api/trading/lighter/import"

payload = {
    "walletIdOrAddress": "0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996",
    "accountIndex": 0,
    "apiKeyIndex": 10,
    "apiPublicKey": "0x...",
    "apiPrivateKey": "0x..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    walletIdOrAddress: '0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996',
    accountIndex: 0,
    apiKeyIndex: 10,
    apiPublicKey: '0x...',
    apiPrivateKey: '0x...'
  })
};

fetch('https://api.tide.ag/api/trading/lighter/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tide.ag/api/trading/lighter/import",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'walletIdOrAddress' => '0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996',
    'accountIndex' => 0,
    'apiKeyIndex' => 10,
    'apiPublicKey' => '0x...',
    'apiPrivateKey' => '0x...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tide.ag/api/trading/lighter/import"

	payload := strings.NewReader("{\n  \"walletIdOrAddress\": \"0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996\",\n  \"accountIndex\": 0,\n  \"apiKeyIndex\": 10,\n  \"apiPublicKey\": \"0x...\",\n  \"apiPrivateKey\": \"0x...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tide.ag/api/trading/lighter/import")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"walletIdOrAddress\": \"0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996\",\n  \"accountIndex\": 0,\n  \"apiKeyIndex\": 10,\n  \"apiPublicKey\": \"0x...\",\n  \"apiPrivateKey\": \"0x...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tide.ag/api/trading/lighter/import")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"walletIdOrAddress\": \"0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996\",\n  \"accountIndex\": 0,\n  \"apiKeyIndex\": 10,\n  \"apiPublicKey\": \"0x...\",\n  \"apiPrivateKey\": \"0x...\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Lighter credentials imported successfully",
  "timestamp": 123
}

{
  "success": false,
  "error": "Missing parameters",
  "message": "walletIdOrAddress, accountIndex, apiKeyIndex, apiPublicKey, and apiPrivateKey are required",
  "timestamp": 123
}

{
  "success": false,
  "error": "No authorization header provided"
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Wallet not found in system. Please connect wallet first.",
  "timestamp": 123
}

POST

api

trading

lighter

import

Import Lighter Credentials

curl --request POST \
  --url https://api.tide.ag/api/trading/lighter/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletIdOrAddress": "0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996",
  "accountIndex": 0,
  "apiKeyIndex": 10,
  "apiPublicKey": "0x...",
  "apiPrivateKey": "0x..."
}
'

import requests

url = "https://api.tide.ag/api/trading/lighter/import"

payload = {
    "walletIdOrAddress": "0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996",
    "accountIndex": 0,
    "apiKeyIndex": 10,
    "apiPublicKey": "0x...",
    "apiPrivateKey": "0x..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    walletIdOrAddress: '0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996',
    accountIndex: 0,
    apiKeyIndex: 10,
    apiPublicKey: '0x...',
    apiPrivateKey: '0x...'
  })
};

fetch('https://api.tide.ag/api/trading/lighter/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tide.ag/api/trading/lighter/import",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'walletIdOrAddress' => '0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996',
    'accountIndex' => 0,
    'apiKeyIndex' => 10,
    'apiPublicKey' => '0x...',
    'apiPrivateKey' => '0x...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tide.ag/api/trading/lighter/import"

	payload := strings.NewReader("{\n  \"walletIdOrAddress\": \"0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996\",\n  \"accountIndex\": 0,\n  \"apiKeyIndex\": 10,\n  \"apiPublicKey\": \"0x...\",\n  \"apiPrivateKey\": \"0x...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tide.ag/api/trading/lighter/import")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"walletIdOrAddress\": \"0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996\",\n  \"accountIndex\": 0,\n  \"apiKeyIndex\": 10,\n  \"apiPublicKey\": \"0x...\",\n  \"apiPrivateKey\": \"0x...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tide.ag/api/trading/lighter/import")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"walletIdOrAddress\": \"0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996\",\n  \"accountIndex\": 0,\n  \"apiKeyIndex\": 10,\n  \"apiPublicKey\": \"0x...\",\n  \"apiPrivateKey\": \"0x...\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Lighter credentials imported successfully",
  "timestamp": 123
}

{
  "success": false,
  "error": "Missing parameters",
  "message": "walletIdOrAddress, accountIndex, apiKeyIndex, apiPublicKey, and apiPrivateKey are required",
  "timestamp": 123
}

{
  "success": false,
  "error": "No authorization header provided"
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Wallet not found in system. Please connect wallet first.",
  "timestamp": 123
}

Import existing Lighter API credentials for a wallet. This endpoint is used when delegation or server wallet generation is not possible, allowing users to provide their own pre-generated API keys from the Lighter platform.

The imported credentials will be securely linked to the authenticated user account. Never share your API private keys.

Features

Credential Import: Link existing Lighter API keys to your HyperDEX account
Secure Storage: Credentials are encrypted and stored securely
Flexible Wallet Linking: Use wallet address or internal wallet ID

When to Use

Use this endpoint when:

You already have Lighter API credentials generated from the Lighter platform
Server-side wallet delegation is not available
You want to use your existing Lighter account with HyperDEX

Request

Method: POST
Endpoint: /api/trading/lighter/import
Authentication: Required (JWT Bearer token)

Headers

Header	Value	Required
`Content-Type`	application/json	Yes
`Authorization`	Bearer <jwt_token>	Yes

Request Body

{
  "walletIdOrAddress": "0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996",
  "accountIndex": 0,
  "apiKeyIndex": 10,
  "apiPublicKey": "0x...",
  "apiPrivateKey": "0x..."
}

Request Parameters

Field	Type	Required	Description
`walletIdOrAddress`	string	Yes	The wallet address or internal wallet ID associated with these credentials
`accountIndex`	number	Yes	The Lighter account index (usually `0` or `1`)
`apiKeyIndex`	number	Yes	The index of the API key being imported
`apiPublicKey`	string	Yes	The public key of the API key pair
`apiPrivateKey`	string	Yes	The private key of the API key pair

Example Request

curl -X POST https://api.tide.ag/api/trading/lighter/import \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "walletIdOrAddress": "0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996",
    "accountIndex": 0,
    "apiKeyIndex": 10,
    "apiPublicKey": "your_public_key",
    "apiPrivateKey": "your_private_key"
  }'

await axios.post('https://api.tide.ag/api/trading/lighter/import', {
  walletIdOrAddress: '0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996',
  accountIndex: 0,
  apiKeyIndex: 10,
  apiPublicKey: 'your_public_key',
  apiPrivateKey: 'your_private_key'
}, {
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN'
  }
});

Success Response

{
  "success": true,
  "message": "Lighter credentials imported successfully",
  "timestamp": 1733215000000
}

Response Fields

Field	Type	Description
`success`	boolean	Operation status
`message`	string	Success message
`timestamp`	number	Unix timestamp in milliseconds

Error Responses

400 Bad Request - Missing Parameters

{
  "success": false,
  "error": "Missing parameters",
  "message": "walletIdOrAddress, accountIndex, apiKeyIndex, apiPublicKey, and apiPrivateKey are required",
  "timestamp": 1733215000000
}

401 Unauthorized - Missing Token

{
  "success": false,
  "error": "No authorization header provided"
}

500 Internal Server Error - Wallet Not Found

{
  "success": false,
  "error": "Internal server error",
  "message": "Wallet not found in system. Please connect wallet first.",
  "timestamp": 1733215000000
}

How to Get Lighter Credentials

Visit Lighter DEX and create an account
Navigate to your account settings
Generate API keys from the dashboard
Note down your:
- accountIndex - Your Lighter account index
- apiKeyIndex - The API key index
- apiPublicKey - Your API public key
- apiPrivateKey - Your API private key

After importing credentials, you can use the standard trading endpoints to place orders on Lighter without providing credentials as query parameters.

If you don’t have existing Lighter credentials, you can generate them directly on the Lighter platform and then import them using this endpoint.

Authorizations

Authorization

string

header

required

JWT token for authentication. Required for smart order execution.

Body

application/json

walletIdOrAddress

string

required

The wallet address or internal wallet ID associated with these credentials

Example:

"0xA5BD439c4d4Fc7cA8B14A9FE77fd5C4FFd7e4996"

accountIndex

integer

required

The Lighter account index (usually 0 or 1)

Example:

0

apiKeyIndex

integer

required

The index of the API key being imported

Example:

10

apiPublicKey

string

required

The public key of the API key pair

Example:

"0x..."

apiPrivateKey

string

required

The private key of the API key pair

Example:

"0x..."

Response

Credentials imported successfully

success

boolean

Example:

true

message

string

Example:

"Lighter credentials imported successfully"

timestamp

integer

Unix timestamp in milliseconds

Getting Started

Market Data

Trading

Positions

Account

System

Guides

Import Lighter Credentials

Features

When to Use

Request

Headers

Request Body

Request Parameters

Example Request

Success Response

Response Fields

Error Responses

400 Bad Request - Missing Parameters

401 Unauthorized - Missing Token

500 Internal Server Error - Wallet Not Found

How to Get Lighter Credentials

Authorizations

Body

Response

​Features

​When to Use

​Request

​Headers

​Request Body

​Request Parameters

​Example Request

​Success Response

​Response Fields

​Error Responses

​400 Bad Request - Missing Parameters

​401 Unauthorized - Missing Token

​500 Internal Server Error - Wallet Not Found

​How to Get Lighter Credentials

Authorizations

Body

Response

Features

When to Use

Request

Headers

Request Body

Request Parameters

Example Request

Success Response

Response Fields

Error Responses

400 Bad Request - Missing Parameters

401 Unauthorized - Missing Token

500 Internal Server Error - Wallet Not Found

How to Get Lighter Credentials