Skip to main content
POST
Add liquidity

Authorizations

Authorization
string
header
required

API key issued by a Hedgin administrator, in the form hv1_<id>_<secret>. <id> is 1 to 48 characters and <secret> is 32 to 128 characters, both from [A-Za-z0-9_-].

Body

application/json
vault
string
required

Vault the transaction acts on.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Example:

"So11111111111111111111111111111111111111112"

position
string
required

DLMM position owned by the vault.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Example:

"So11111111111111111111111111111111111111112"

amountX
string
required

Non-negative integer in token base units, as a decimal string. Must fit in u64 (at most 18446744073709551615). Never a JSON number.

Maximum string length: 20
Pattern: ^\d+$
Example:

"1000000"

amountY
string
required

Non-negative integer in token base units, as a decimal string. Must fit in u64 (at most 18446744073709551615). Never a JSON number.

Maximum string length: 20
Pattern: ^\d+$
Example:

"1000000"

shape
enum<string>
required

Meteora DLMM liquidity distribution.

Available options:
spot,
curve,
bidAsk
maxActiveBinSlippage
integer
required

How many bins the pool's active bin may move before the transaction fails.

Required range: 0 <= x <= 1000
lowerBinId
integer

Inclusive first bin of a sub-range. Send it together with upperBinId or omit both.

upperBinId
integer

Inclusive last bin of a sub-range. Must lie inside the position.

Response

Build result. One step, or a batch for a wide position.

vault
string
required

Base58 Solana public key. The server decodes it and rejects anything that is not 32 bytes.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Example:

"So11111111111111111111111111111111111111112"

result
Single step · object
required

One unsigned transaction and its ticket. Builders can add action metadata fields next to these.