Get Routing Recommendation

curl --request GET \
  --url https://api.tide.ag/api/trade/routing/{symbol} \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.tide.ag/api/trade/routing/{symbol}', 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/trade/routing/{symbol}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.tide.ag/api/trade/routing/{symbol}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tide.ag/api/trade/routing/{symbol}")

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

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

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

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "side": "BUY",
    "routing": {
      "recommended": "lighter",
      "price": 88308.1,
      "reason": "Best ask price",
      "savings": 10.5,
      "savingsPercent": 0.012,
      "alternatives": {
        "hyperliquid": {
          "price": 89207,
          "available": true
        },
        "aster": {
          "price": 89221.9,
          "available": true
        },
        "lighter": {
          "price": 88308.1,
          "available": true
        }
      }
    }
  },
  "timestamp": 123
}

{
  "success": false,
  "error": "No routing data available for symbol",
  "timestamp": 123
}

GET

api

trade

routing

{symbol}

Get Routing Recommendation

curl --request GET \
  --url https://api.tide.ag/api/trade/routing/{symbol} \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.tide.ag/api/trade/routing/{symbol}', 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/trade/routing/{symbol}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.tide.ag/api/trade/routing/{symbol}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tide.ag/api/trade/routing/{symbol}")

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

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

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

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "side": "BUY",
    "routing": {
      "recommended": "lighter",
      "price": 88308.1,
      "reason": "Best ask price",
      "savings": 10.5,
      "savingsPercent": 0.012,
      "alternatives": {
        "hyperliquid": {
          "price": 89207,
          "available": true
        },
        "aster": {
          "price": 89221.9,
          "available": true
        },
        "lighter": {
          "price": 88308.1,
          "available": true
        }
      }
    }
  },
  "timestamp": 123
}

{
  "success": false,
  "error": "No routing data available for symbol",
  "timestamp": 123
}

Fetches the current best exchange and price for a symbol without executing a trade. The response shows which exchange currently offers the best price along with alternative venues and pricing context.

Features

Real-time insights: Surface the venue offering the best bid or ask instantly
Contextual pricing: Includes savings metrics and alternative venue pricing
Configurable direction: Toggle BUY or SELL recommendations via query params
Credential-free: Preview routing outcomes without submitting trade credentials

Use Cases

Power pre-trade analytics or UI previews before executing a position
Monitor venue spreads to decide when to re-route algorithmic order flow
Feed routing data into risk systems to anticipate liquidity constraints
Provide traders with transparency on venue selection logic in dashboards

Request

Method: GET
Endpoint: /api/trade/routing/{symbol}
Path Parameter: symbol (e.g., BTC, ETH, SOL)
Query Parameter: side (required) - BUY or SELL

Example Request

curl -X GET "https://api.tide.ag/api/trade/routing/BTC?side=BUY"

Success Response

{
  "success": true,
  "data": {
    "symbol": "BTC",
    "side": "BUY",
    "routing": {
      "recommended": "lighter",
      "price": 88308.1,
      "reason": "Best ask price",
      "savings": 10.50,
      "savingsPercent": 0.012,
      "alternatives": {
        "hyperliquid": { "price": 89207, "available": true },
        "aster": { "price": 89221.9, "available": true },
        "lighter": { "price": 88308.1, "available": true },
        "avantis": { "price": 89150.5, "available": true }
      }
    }
  },
  "timestamp": 1678900000000
}

Response Fields

Field	Type	Description
`symbol`	string	Asset symbol passed in the request
`side`	string	`BUY` or `SELL`
`routing.recommended`	string	Exchange that currently offers the best execution
`routing.price`	number	Best execution price
`routing.reason`	string	Why the exchange was selected
`routing.savings`	number	Estimated savings (in quote asset) compared to next-best venue
`routing.savingsPercent`	number	Percent improvement over alternatives
`routing.alternatives`	object	Pricing details for each supported exchange

Error Responses

404 Not Found - No Routing Data

{
  "success": false,
  "error": "No routing data available for symbol",
  "timestamp": 1678900000000
}

Use this endpoint to preview which venue will be selected before placing a trade, or to power UI components that surface best-exchange insights in real-time.

Authorizations

X-API-KEY

string

header

required

API key for authentication. Also requires X-API-SECRET, X-API-TIMESTAMP, and X-API-SIGNATURE headers for private endpoints.

Path Parameters

symbol

string

required

Asset symbol (e.g., BTC, ETH)

Example:

"BTC"

Query Parameters

side

enum<string>

required

Order side (BUY or SELL)

Available options:

BUY,

SELL

Response

Routing recommendation

success

boolean

data

object

Show child attributes

timestamp

integer

Getting Started

Market Data

Trading

Positions

Account

System

Guides

Get Routing Recommendation

Features

Use Cases

Request

Example Request

Success Response

Response Fields

Error Responses

404 Not Found - No Routing Data

Authorizations

Path Parameters

Query Parameters

Response

​Features

​Use Cases

​Request

​Example Request

​Success Response

​Response Fields

​Error Responses

​404 Not Found - No Routing Data

Authorizations

Path Parameters

Query Parameters

Response

Features

Use Cases

Request

Example Request

Success Response

Response Fields

Error Responses

404 Not Found - No Routing Data