For the complete documentation index, see llms.txt. Markdown versions of the documentation pages are available from that index.

Introducing Build with AI: Connect your agents to reliable onchain data with more than 50+ tools cover all tokens to wallets on Solana via MCP, CLI, and Skills. Learn How

get market positions

gethttps://pro-api.solscan.io/v2.0/market/positions

Get market positions

Query parameters

address

string

required

Market address/Pool address

page

number

Page number for pagination

page_size

number

Number of items per page

sort_by

string

Field to sort by

sort_order

string

Sort order

in_range

boolean

Filter positions that are in range or out of range. In range means the current price is between the price range of position, otherwise is out of range

Responses

200

OK

Response Body (application/json)

success

boolean

Request status

position_id

string

The position id

pool_id

string

The market id

created_time

number

Timestamp of the position creation

program

string

The program owner

token_address

string

The token address of position

position_owner

string

The owner of the position

position_value

number

The value of the position

position_type

string

The type of the position

is_pos_in_range

boolean

Position is in or out of range

token_1

string

Address of token

token_2

string

Address of token

amount_1

number

Amount of token_1 in position

amount_2

number

Amount of token_2 in position

locked_values

number

Value of the locked liquidity in the position. This field may be absent if the position has no locked liquidity

locked_liquidity_rate

number

Ratio of locked liquidity (permanent locked + vested liquidity) to the total liquidity of the pool, from 0 to 1. This field may be absent if the position has no locked liquidity

current_price

number

Current price

lower_price

number

Lower price

upper_price

number

Upper price

value

number

Position value

is_in_range

boolean

Whether the position is in range

400

Bad Request

Response Body (application/json)

401

Authentication failed

Response Body (application/json)

429

Too Many Requests

Response Body (application/json)

500

Internal Server Error

Response Body (application/json)

Authentication

Response

Click Try It! to start a request and see the response here!

Response examples