Skip to main content
POST
/
router
/
buy
Buy position through router
curl --request POST \
  --url https://mainnet.base.org/router/buy \
  --header 'Content-Type: application/json' \
  --data '
{
  "marketAddress": "<string>",
  "amount": 2,
  "isBased": true,
  "minAmountReceived": 1,
  "deadline": 123
}
'
{
  "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.

Body

application/json
​
marketAddress
string
required

Address of the market

​
amount
integer<uint64>
required

USD amount to buy

Required range: x >= 1
​
isBased
boolean
required

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

​
minAmountReceived
integer<uint64>
required

Minimum size of position to receive

Required range: x >= 0
​
deadline
integer<uint256>
required

Unix timestamp after which transaction will revert

Response

Position bought successfully through router

​
transactionHash
string

Transaction hash

​
blockNumber
integer<uint256>

Block number where transaction was mined

​
gasUsed
integer<uint256>

Amount of gas used

​
success
boolean

Whether transaction was successful