Sologenic

Supported Chains

Available on XRPL Mainnet and Testnet

Available Endpoints:

Click on the endpoint to jump to the section with full details

• /getprice GET - Returns the swap quotation for a given token pair on Sologenic.

• /getuserliquidity GET - Returns the balance of a particular token pair of accounts.

• /getpoolliquidity GET - Returns the total liquidity for a specified pool.

• /gettokenliquidity GET - Returns the individual token liquidity within the specified liquidity pool.

• /swap POST - Initiate a swap transaction on a specified DEX.

• /addliquidity POST - Add liquidity to a specified pool in a specified DEX.

• /removeliquidityPOST - Remove liquidity from a specified pool for a specified DEX.

DEX IDs

Many endpoints have a parameter where you can provide a DEX ID.

Below is a list of DEX IDs related to Sologenic. For a complete list and more information, please see the DEX ID page.

DEX Name	Chain	DEX ID
Sologenic	XRPL Mainnet	3500
Sologenic	XRPL Testnet	3501

Endpoint Details

/getprice

Returns the swap quotation for a given token pair.

GET https://api.expand.network/dex/getprice

Query Parameter

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
amountIn*	String	Amount of token.
path*	String	Comma separated values of token addresses whose price is to be fetched.

Sample Request

https://api.expand.network/dex/getprice?path=PHNIX%3ArDFXbW2ZZCG5WgPtqwNiA2xZokLMm9ivmN,XRP&amountIn=10000000000000000000&dexId=3500

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "amountIn": "10000000000000000000",
    "path": [
      "PHNIX:rDFXbW2ZZCG5WgPtqwNiA2xZokLMm9ivmN",
      "XRP"
    ],
    "amountsOut": [
      "10000000000000000000",
      "50600"
    ]
  }
}

/getuserliquidity

Returns the balance of a particular token pair of an account.

GET https://api.expand.network/dex/getuserliquidity

Query Parameter

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
address*	String	Public address of liquidity provider.
poolAddress*	String	Pool address whose liquidity is to be fetched.

Sample Request

https://api.expand.network/dex/getuserliquidity?dexId=3500&poolAddress=rakZprdzwsUJ1rD2ouhYYAVP7tPbhrCbtz&address=rfkgjHxPbq1z6i8boURnEXY4qe4JFbiFLQ

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "pairAddress": "rakZprdzwsUJ1rD2ouhYYAVP7tPbhrCbtz",
    "liquidity": "133406"
  }
}

/getpoolliquidity

Returns the total liquidity for a specified pool.

GET https://api.expand.network/dex/getpoolliquidity

Query Parameter

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
poolAddress*	String	Pool address whose liquidity is to be fetched.

Sample Request

https://api.expand.network/dex/getpoolliquidity?dexId=3500&poolAddress=rakZprdzwsUJ1rD2ouhYYAVP7tPbhrCbtz

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "totalLiquidity": "5388788949277917000000000"
  }
}

/gettokenliquidity

Returns the individual token liquidity within the specified liquidity pool.

GET https://api.expand.network/dex/gettokenliquidity

Query Parameter

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
poolAddress*	String	Pool address whose liquidity is to be fetched.

Sample Request

https://api.expand.network/dex/gettokenliquidity?dexId=3500&poolAddress=rLjUKpwUVmz3vCTmFkXungxwzdoyrWRsFG

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "XRP": "3834555737847",
    "CRYPTO": "301396241674017700000"
  }
}

/swap

Initiate a swap transaction on a specified DEX.

POST https://api.expand.network/dex/swap

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
path*	String	Comma separated values of token addresses.
amountIn*	String	Amount of token to be swapped.
amountOutMin*	String	Minimum amount accepted as a result of swap.
from*	String	Address of the sender of the token.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 10

Sample Request

{
    "path": [
        "XRP",
        "SOLO:rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz"
    ],
    "amountIn": "20000",
    "amountOutMin": "2324",
    "from": "rfkgjHxPbq1z6i8boURnEXY4qe4JFbiFLQ",
    "dexId": "3500"
}

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "1600",
    "from": "rfkgjHxPbq1z6i8boURnEXY4qe4JFbiFLQ",
    "gas": "12",
    "data": "eyJUcmFuc2FjdGlvblR5cGUiOiJPZmZlckNyZWF0ZSIsIkFjY291bnQiOiJyZmtnakh4UGJxMXo2aThib1VSbkVYWTRxZTRKRmJpRkxRIiwiVGFrZXJQYXlzIjp7ImN1cnJlbmN5IjoiNTM0RjRDNEYwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMCIsImlzc3VlciI6InJzb0xvMlMxa2lHZUNjbjZoQ1VYVnJDcEdNV0xyUnJMWnoiLCJ2YWx1ZSI6IjIuMzI0ZS0xMiJ9LCJGbGFncyI6NjU1MzYwLCJUYWtlckdldHMiOiIyMDAwMCIsIkZlZSI6IjEyIiwiU2VxdWVuY2UiOjU4Mjc0MDc3LCJMYXN0TGVkZ2VyU2VxdWVuY2UiOjk0MzQ0MDMwfQ==",
    "referenceId": "6e9a1fbc246846698821985ce7fe43ab"
  }
}

/addliquidity

Add liquidity to a specified pool in a specified DEX.

POST https://api.expand.network/dex/addliquidity

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
path*	String	Comma separated values of token addresses.
amountIn*	String	Amount of token0 and token1 to be added.
slippage	String	Percentage of total swap value. By default, 1. 0 <= slippage value <= 10
from*	String	Address of the sender of the token.
amountOutMin*	String	Minimum amount accepted as a result of add liquidity.

Sample Request

{
    "dexId": "3500",
    "amountIn": [
        "1000000",
        "1000000"
    ],
    "from": "rPJ2kXNTseFAD1qotRXBtv7cd3x8ZN4BkP",
    "path": [
        "XRP",
        "SOLO:rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz"
    ],
    "slippage": "10",
    "amountOutMin": "3"
}

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "1600",
    "from": "rPJ2kXNTseFAD1qotRXBtv7cd3x8ZN4BkP",
    "gas": "12",
    "data": "eyJBY2NvdW50IjoiclBKMmtYTlRzZUZBRDFxb3RSWEJ0djdjZDN4OFpONEJrUCIsIkFtb3VudCI6IjEwMDAwMDAiLCJBbW91bnQyIjp7ImN1cnJlbmN5IjoiNTM0RjRDNEYwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMCIsImlzc3VlciI6InJzb0xvMlMxa2lHZUNjbjZoQ1VYVnJDcEdNV0xyUnJMWnoiLCJ2YWx1ZSI6IjFlLTkifSwiQXNzZXQiOnsiY3VycmVuY3kiOiJYUlAifSwiQXNzZXQyIjp7ImN1cnJlbmN5IjoiNTM0RjRDNEYwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMCIsImlzc3VlciI6InJzb0xvMlMxa2lHZUNjbjZoQ1VYVnJDcEdNV0xyUnJMWnoifSwiRmxhZ3MiOjEwNDg1NzYsIkxQVG9rZW5PdXQiOnsiY3VycmVuY3kiOiIwMzQzMTc4MDFCMDg1MDA0NDZCQzUzM0I3MTgzNTlCQzAxNEQ2QjM3IiwiaXNzdWVyIjoick1FSm85SDVYdlRlMTdVb0FKemo4anRLVnZUUmN4d25nbyIsInZhbHVlIjoiMi43In0sIlRyYW5zYWN0aW9uVHlwZSI6IkFNTURlcG9zaXQiLCJGZWUiOiIxMiIsIlNlcXVlbmNlIjo4ODE3MjQ4NSwiTGFzdExlZGdlclNlcXVlbmNlIjo5NDM0NDA0M30=",
    "referenceId": "18fddf710a5b4ebbac7c322387fe6a4a"
  }
}

/removeliquidity

Remove liquidity from a specified pool for a specified DEX.

POST https://api.expand.network/dex/removeliquidity

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
dexId*	String	Refer to the DEX ID page for details.
path*	String	Comma separated values of token addresses.
from*	String	Address of the sender of the token.
liquidity*	String	The liquidity to be removed.

Sample Request

{
    "dexId": "3500",
    "liquidity": "1000000",
    "from": "rfkgjHxPbq1z6i8boURnEXY4qe4JFbiFLQ",
    "path": [
        "XRP",
        "SOLO:rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz"
    ]
}

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "1600",
    "from": "rfkgjHxPbq1z6i8boURnEXY4qe4JFbiFLQ",
    "gas": "12",
    "data": "eyJBY2NvdW50IjoicmZrZ2pIeFBicTF6Nmk4Ym9VUm5FWFk0cWU0SkZiaUZMUSIsIkxQVG9rZW5JbiI6eyJjdXJyZW5jeSI6IjAzNDMxNzgwMUIwODUwMDQ0NkJDNTMzQjcxODM1OUJDMDE0RDZCMzciLCJpc3N1ZXIiOiJyTUVKbzlINVh2VGUxN1VvQUp6ajhqdEtWdlRSY3h3bmdvIiwidmFsdWUiOiIxMDAwMDAwIn0sIkFzc2V0Ijp7ImN1cnJlbmN5IjoiWFJQIn0sIkFzc2V0MiI6eyJjdXJyZW5jeSI6IjUzNEY0QzRGMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAiLCJpc3N1ZXIiOiJyc29MbzJTMWtpR2VDY242aENVWFZyQ3BHTVdMclJyTFp6In0sIkZsYWdzIjo2NTUzNiwiVHJhbnNhY3Rpb25UeXBlIjoiQU1NV2l0aGRyYXciLCJGZWUiOiIxMiIsIlNlcXVlbmNlIjo1ODI3NDA3NywiTGFzdExlZGdlclNlcXVlbmNlIjo5NDM0NDA1NH0=",
    "referenceId": "57d5293a14be48369d05fbcd44e718a0"
  }
}