Add Liquidity

Testnet Env

https://testnet.trade.vessel.finance

POST

/api/v1/amm/add

Last modified:2024-10-15 06:23:56

Add Liquidity allows users to add liquidity to an Automated Market Maker (AMM) pool. Users must provide the pool ID, price tick range, base and quote asset amounts, a nonce, and a signature for authentication. Upon successful execution, the API returns the amounts of base and quote assets added to the pool.

Request

Header Params

VESSEL-TIMESTAMP

integer

required

VESSEL-API-KEY

string

required

Default:

VESSEL-PASSPHRASE

string

required

Default:

VESSEL-SIGNATURE

string

required

Use signRequest script to generate

Body Params application/json

poolId

string

required

The unique identifier of the AMM pool to add liquidity.

tickIndexL

string

required

The minimum price tick index

tickIndexR

string

required

The maximum price tick index.

baseAmount

string

required

The amount of the base asset to add to the pool.

quoteAmount

string

required

The amount of the quote asset to add to the pool.

nonce

string

required

A unique identifier for the request, typically a Unix timestamp indicating the time at which the request was made. It helps prevent replay attacks by ensuring that each request is unique.

signature

string

required

The cryptographic signature generated using the Poseidon algorithm. Refer to the Poseidon Signature Guide for details on generating the signature.

Example

{
  "poolId": 2,
  "tickIndexL": 222,
  "tickIndexR": 350,
  "baseAmount": 1,
  "quoteAmount": 100000,
  "nonce": "1715321003889",
  "signature": "0xa742f3a4296aa5d8221451793f2c2d835f0aa484b37c021fa7953a6aa78c053f67972dc251ce763b0c4b8a7b843d5d4f28c6b5d6dff674a44a0850966e598123"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://testnet.trade.vessel.finance/api/v1/amm/add' \
--header 'VESSEL-TIMESTAMP;' \
--header 'VESSEL-TIMESTAMP;' \
--header 'VESSEL-API-KEY;' \
--header 'VESSEL-PASSPHRASE;' \
--header 'VESSEL-SIGNATURE;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "poolId": 2,
    "tickIndexL": 222,
    "tickIndexR": 350,
    "baseAmount": 1,
    "quoteAmount": 100000,
    "nonce": "1715321003889",
    "signature": "0xa742f3a4296aa5d8221451793f2c2d835f0aa484b37c021fa7953a6aa78c053f67972dc251ce763b0c4b8a7b843d5d4f28c6b5d6dff674a44a0850966e598123"
}'

Responses

🟢200OK

application/json

Body

baseAssetAmount

string

required

The amount of base asset added to the pool.

quoteAssetAmount

string

required

The amount of quote asset added to the pool.

Examples

SuccessException

{
  "baseAssetAmount": "0.6808",
  "quoteAssetAmount": "89747.84"
}

Modify Order

Remove Liquidity