Skip to main content
GET
/
market
/
{marketAddress}
/
usdToTokens
Calculate USD to tokens conversion
curl --request GET \
  --url https://mainnet.base.org/market/{marketAddress}/usdToTokens
{
  "tokensIn": 123,
  "tokensOut": 123,
  "protocolFeeAmount": 123,
  "creatorFeeAmount": 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

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

Query Parameters

​
amountIn
integer<uint256>
required

USD amount to convert

Required range: x >= 1
​
buyBased
boolean
required

True if buying Based, false if buying Cringe

Response

200 - application/json

Conversion calculated successfully

​
tokensIn
integer<int64>

Tokens deposited to AMM

​
tokensOut
integer<int64>

Tokens received from AMM

​
protocolFeeAmount
integer<uint256>

Protocol fee amount

​
creatorFeeAmount
integer<uint256>

Creator fee amount