REST API

Front-end developers may use our REST API (https://api.alexgo.io) to access the latest market data on ALEX.

Returns all available swap pairs

get

Returns all existing swap pairs with their current volumes and prices in USD.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/allswaps'

200

403

404

200

{
  "data": [
    {
      "id": 7,
      "base": "token-alex",
      "baseSymbol": "alex",
      "baseId": "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex",
      "quote": "token-wban",
      "quoteSymbol": "BANANA",
      "quoteId": "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wban",
      "baseVolume": 105.45894916044628,
      "quoteVolume": 98.15140304673803,
      "lastBasePriceInUSD": 0.03150216,
      "lastQuotePriceInUSD": 0.005409090542472804
    }
  ]
}

Successfully returning all existing swaps.

Returns pool stats

get

Returns detailed statistics for a specific swap pool including volumes, fees, liquidity metrics and APR. Data is provided as a time series, with each entry corresponding to a specific Stacks block height.

Path parameters

pool_token_idone ofrequired

Pool token ID of swap pool.

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0.

limitanyrequired

Specifies number of data to be returned, default value is 10.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/pool_stats/{pool_token_id}?limit=null'

200

403

404

200

{
  "token": 13,
  "pool_status": [
    {
      "pool_token": 13,
      "block_height": 746617,
      "token_x": "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wstx-v2",
      "token_y": "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex",
      "volume_x_24h": 112443.97784314597,
      "volume_y_24h": 111321.83151559353,
      "volume_24h": 225221.63555752003,
      "volume_x_7d": 772478.6819111536,
      "volume_y_7d": 763925.8164915497,
      "volume_7d": 1548772.3056866901,
      "fee_rebate_x_24h": 83.41996769813575,
      "fee_rebate_y_24h": 196.64898177152597,
      "fee_rebate_24h": 276.89283447830627,
      "fee_rebate_x_7d": 953.7354657850966,
      "fee_rebate_y_7d": 19723.707926126946,
      "fee_rebate_7d": 1909.7699233141293,
      "est_pool_token_price": 1.8974830418148833e-7,
      "liquidity": 4092767.3621235755,
      "total_supply": 4092767.3621156355,
      "apr_7d": 2.433093588672123,
      "burn_block_time": 1741601675,
      "sync_at": "2025-03-10T10:33:32.378+00:00"
    }
  ]
}

Successfully returning pool stats.

Returns daily pool volume

get

Returns 24-hour pool volume history for a specific swap pool. Data is provided as a time series, with each entry corresponding to a specific Stacks block height.

Path parameters

pool_token_idone ofrequired

Pool token ID of swap pool.

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0.

limitanyrequired

Specifies number of data to be returned, default value is 10.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/pool_volume/{pool_token_id}?limit=null'

200

403

404

200

{
  "token": 13,
  "volume_values": [
    {
      "block_height": 748628,
      "volume_24h": 294318.0656719518
    }
  ]
}

Successfully returning volumes.

Returns daily volumes of token in time series

get

Path parameters

pool_token_idone ofrequired

Pool token ID of swap pool.

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0.

limitanyrequired

Specifies number of data to be returned, default value is 10.

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/volume_24h/{pool_token_id}?limit=null'

200

403

404

200

No body

Successfully returning volumes

Returns weekly pool volume

get

Returns 7-day pool volume history for a specific swap pool. Data is provided as a time series, with each entry corresponding to a specific Stacks block height.

Path parameters

pool_token_idone ofrequired

Pool token ID of swap pool.

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0.

limitanyrequired

Specifies number of data to be returned, default value is 10.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/volume_7d/{pool_token_id}?limit=null'

200

403

404

200

{
  "token": 13,
  "volume_values": [
    {
      "block_height": 748811,
      "volume_7d": 1517660.0316130652
    }
  ]
}

Successfully returning volumes.

Returns pool liquidity

get

Returns liquidity history for a specific swap pool. Data is provided as a time series, with each entry corresponding to a specific Stacks block height.

Path parameters

pool_token_idone ofrequired

Pool token ID of swap pool.

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0.

limitanyrequired

Specifies number of data to be returned, default value is 10.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/pool_liquidity/{pool_token_id}?limit=null'

200

403

404

200

{
  "token": 13,
  "liquidity_value": [
    {
      "block_height": 748855,
      "liquidity": 3769712.496803321
    }
  ]
}

Successfully returning liquidity.

Returns liquidity of token in time series

get

Path parameters

pool_token_idone ofrequired

Pool token ID of swap pool.

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0.

limitanyrequired

Specifies number of data to be returned, default value is 10.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/liquidity/{pool_token_id}?limit=null'

200

403

404

200

{
  "token": 13,
  "liquidity_value": [
    {
      "block_height": 748855,
      "liquidity": 3769712.496803321
    }
  ]
}

Successfully returning liquidity

Returns pool fee

get

Returns pool's fee rebate history for a specific swap pool. Data is provided as a time series, with each entry corresponding to a specific Stacks block height.

Path parameters

pool_token_idone ofrequired

Pool token ID of swap pool.

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0.

limitanyrequired

Specifies number of data to be returned, default value is 10.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/fee/{pool_token_id}?limit=null'

200

403

404

200

{
  "pool_token": 13,
  "fee_value": [
    {
      "block_height": 748936,
      "fee_rebate_24h": 615.3625117185487,
      "fee_rebate_7d": 3173.3596157582247
    }
  ]
}

Successfully returning fee

Returns total TVL(total value locked) value of ALEX platform

get

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/stats/tvl'

200

403

404

200

No body

Successfully returning TVL

Returns token TVL(total value locked) in time series

get

Path parameters

tokenstringrequired

Query parameters

offsetanyoptional

Specifies the offset of data to be returned, default value is 0

limitanyoptional

Specifies number of data to be returned, default value is 10

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/stats/tvl/{token}'

200

403

404

200

No body

Successfully returning liquidity

Returns total supply of queried token eg. age000-governance-token

get

Path parameters

tokenstringrequired

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/stats/total_supply/{token}'

200

403

404

200

No body

Successfully returning total supply

Returns price of token

get

Path parameters

tokenone ofrequired

name of token eg. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/price/{token}'

200

403

404

200

No body

Successfully returning price

Returns pool token price value of ALEX platform

get

Path parameters

pool_token_idone ofrequired

pool token id of swap pool eg. 13

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/pool_token_price/{pool_token_id}'

200

403

404

200

No body

Successfully returning Pool token price

Returns pool token price value of ALEX platform

get

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/pool_token_stats'

200

403

404

200

No body

Successfully returning all existing pool token stats

Returns price history of token

get

Path parameters

tokenone ofrequired

name of token eg. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex

Query parameters

order_byanyoptional

Specifies the order of block height to be returned, default value is desc

end_block_heightanyoptional

Specifies the end block height of data to be returned

start_block_heightanyoptional

Specifies the start block height of data to be returned

offsetanyoptional

Specifies the offset of data to be returned, default value is 0

limitanyoptional

Specifies number of data to be returned, default value is 10

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/price_history/{token}'

200

403

404

200

No body

Successfully returning price history

Returns all existing pairs

get

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/pairs'

200

403

404

200

No body

Successfully returning all existing pairs

Returns all markets statistics for the last 24 hours

get

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/tickers'

200

403

404

200

No body

Successfully returning all markets statistics for the last 24 hours

get

Path parameters

ticker_idone ofrequired

A ticker with delimiter between different cryptoassets eg. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex_stx

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/ticker/{ticker_id}'

200

403

404

200

No body

Successfully returning all historical trades of certain ticker

get

Path parameters

tickerone ofrequired

A ticker with delimiter between different cryptoassets eg. ALEX_WSLM

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/orderbook/{ticker}'

200

403

404

200

No body

Successfully returning all historical trades of certain ticker

Returns all existing historical trades

get

Path parameters

pool_token_idone ofrequired

pool token id of swap pool eg. 13

Query parameters

limitanyrequired

Specifies number of recent block heights to be returned, default value is 1000

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/historical_swaps/{pool_token_id}?limit=null'

200

403

404

200

No body

Successfully returning all historical trades of certain ticker

get

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v2/coin-gecko/pairs'

200

200

No body

get

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v2/coin-gecko/tickers'

200

200

[
  {
    "ticker_id": "SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.token-slunr_stx",
    "pool_id": "SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.token-amm-swap-pool-v1-1",
    "base_currency": "SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.token-slunr",
    "target_currency": "stx",
    "base": "sLUNR",
    "target": "STX",
    "last_price": 0.08540716070881907,
    "base_volume": 0.08540716070881907,
    "target_volume": 22589.502469,
    "liquidity_in_usd": 22062.86716874599
  }
]

Get all tickers from AMM

get

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/public/pairs'

200

200

{
  "data": [
    {
      "pool_id": 13,
      "token_x": "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wxusd",
      "wrapped_token_x": "SP2TZK01NKDC89J6TA56SA47SDF7RTHYEQ79AAB9A.Wrapped-USD",
      "token_y": "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wusda",
      "wrapped_token_y": "SP2C2YFP12AJZB4MABJBAJ55XECVS7E4PMMZ89YZR.usda-token"
    }
  ]
}

Get all token pairs from AMM

get

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.alexgo.io/v1/public/amm-pool-stats'

200

200

{
  "data": [
    {
      "pool_id": 13,
      "target_token": "STX",
      "base_token": "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex",
      "tvl": "4800976.56479834",
      "apy": "0.017392667325066296"
    }
  ]
}

Get all stats of AMM pools