Skip to main content
GET
/
market
/
{marketAddress}
/
userHoldings
/
{userAddress}
Get user holdings
curl --request GET \
  --url https://mainnet.base.org/market/{marketAddress}/userHoldings/{userAddress}
{
  "holdings": 123,
  "positionType": "based",
  "absoluteAmount": 123
}
This is a smart contract view function. The curl example shown is for illustration. To call this function, use web3 libraries (ethers.js, viem, web3.py) or JSON-RPC directly.

Path Parameters

​
marketAddress
string
required

Address of the market contract

​
userAddress
string
required

Address of the user

Response

200 - application/json

User holdings retrieved successfully

​
holdings
integer

User holdings (positive for Based, negative for Cringe)

​
positionType
enum<string>

Type of position held

Available options:
based,
cringe,
none
​
absoluteAmount
integer

Absolute amount of tokens held

⌘I