Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Call public/auth with grant_type: coinbase_cdp and a CDP JWT. Send the returned access_token as Authorization: Bearer.

Query Parameters

instrument_name
string
required

Instrument name Unique instrument identifier

Example:

"BTC-PERPETUAL"

subaccount_id
integer

The user id for the subaccount. Available to retail-broker callers; defaults to the authenticated account.

isolated
boolean
default:false

If true, evaluates maximum order size under isolated margin scope.

leverage
number

Custom hypothetical leverage to evaluate order size limits against. Must be between 1 and the account's effective maximum leverage.

Required range: x >= 1
taker_fee_rate
number

Hypothetical non-negative taker fee rate override. Explicit overrides require fee-rate override authorization.

Required range: x >= 0
price
number

Positive hypothetical order price. Uses current book and mark prices if omitted.

Response

200 - application/json

Success response

jsonrpc
enum<string>
required

The JSON-RPC version (2.0)

Available options:
2.0
result
object
required
id
integer

The id that was sent in the request