Skip to main content
POST
Fund a wide position

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"

targetUpperBinId
integer
required

Inclusive last bin the position must reach.

amountX
string
required

Token X to add, base units.

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

"1000000"

amountY
string
required

Token Y to add, base units.

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
activeBinId
integer
required

Active bin observed when the flow started. The build fails with 409 Stale when the live active bin is further away than maxActiveBinSlippage.

cursorBinId
integer
required

First bin still to fund. Must lie inside the position or selection.

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. A batch.

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
object[]
required
Minimum array length: 1