Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <jwt> for user auth or Authorization: Bearer sk_{keyId}_{secret} for API key auth.

Body

application/json
asset
string
required

Token address. Direction is implicit from side.

networkId
string
required

common.NetworkId enum name (SOL, BASE, BSC, MONAD, …).

rationale
string
required

Why you're suggesting this trade. ≤500 chars.

side
string
required

BUY or SELL.

amountInUsd
number<double> | null

Optional sizing hint in USD.

confidence
string | null

Optional confidence: LOW, MEDIUM, or HIGH.

Response

Suggestion created

V2 success response envelope

data
object
required

Outbound TradeSuggestion JSON shape (response from create / list / dismiss / ack). The state field is derived; the timestamps remain the source of truth.

requestId
string
required
pagination
object | null

Page-based pagination info (per RFC)