Skip to main content
POST
/
market
/
{marketAddress}
/
buy
Buy position in market
curl --request POST \
  --url https://mainnet.base.org/market/{marketAddress}/buy \
  --header 'Content-Type: application/json' \
  --data '
{
  "beneficiary": "<string>",
  "amount": 2,
  "isBased": true,
  "minAmountReceived": 1
}
'
{
  "transactionHash": "<string>",
  "blockNumber": 123,
  "gasUsed": 123,
  "success": true
}
This is a smart contract write 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

Pattern: ^0x[a-fA-F0-9]{40}$

Body

application/json
​
beneficiary
string
required

Address that will receive the position

Pattern: ^0x[a-fA-F0-9]{40}$
​
amount
integer<uint64>
required

USD amount to buy (settlement token units)

Required range: x >= 1
​
isBased
boolean
required

Whether to buy Based (true) or Cringe (false)

​
minAmountReceived
integer<uint64>
required

Minimum position size to receive (slippage protection)

Required range: x >= 0

Response

Position bought successfully

​
transactionHash
string

Transaction hash

Pattern: ^0x[a-fA-F0-9]{64}$
​
blockNumber
integer<uint256>

Block number where transaction was mined

​
gasUsed
integer<uint256>

Amount of gas used

​
success
boolean

Whether transaction was successful