Skip to main content
POST
cURL
To avoid ambiguity, we denote the smallest possible multiple of USDC (0.000001 USDC) as one uusdc, which stands for µUSDC (micro-USDC), and denote the smallest possible multiple of a contract (0.01 contract) as one ccontract (centicontract).User-facing USDC balances are specified as fixed-point strings (e.g. "1.2625" for USDC). Contract quantities in the API and SDK are specified as integer ccontracts strings (e.g. "1050" for 10.50 contracts at precision 2).

Body

application/json
chain
enum<string>
required

Chain to execute the action on; one of: base, bsc

Available options:
base,
bsc
Example:

"base"

marketId
string
required

ID of the market to buy/sell in

Example:

"PRES-2024"

ccontracts
string
required

Number of ccontracts as a positive integer string (1 contract = 100 ccontracts).

Example:

"1050"

priceUusdc
string
required

Price per contract in µUSDC (micro-USDC, 1 µUSDC = 0.000001 USD). Must be positive integer string.

Example:

"750000"

action
enum<string>
required

Action to execute

Available options:
buy,
sell
Example:

"buy"

side
enum<string>
required

Side of the market (yes or no)

Available options:
yes,
no
Example:

"yes"

userAddress
string
required

User wallet address

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

"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

signature
string
required

EIP-712 signature from the user authorizing the order

Example:

"0x..."

expiry
number
required

Unix timestamp when the authorization expires

Example:

1234567890

devAccountId
string

Optional dev account ID to attribute this order to

Example:

"bison"

Response

Order placed successfully

success
boolean
required
orderId
string
required
status
string
required
message
string