Skip to main content
POST

Authorizations

​
x-api-key
string
header
required

Headers

​
Idempotency-Key
string

Optional. Replaying the same key for the same user returns the cached result without a second buy.

​
x-signature
string

HMAC-SHA256 signature: HMAC-SHA256(secretKey, timestamp + METHOD + path + body). Required for API-key authenticated requests (JWT/OAuth session auth is exempt).

​
x-timestamp
string

Request timestamp in epoch milliseconds. Required with x-signature for API-key auth. Rejected if drift exceeds 5 minutes.

Body

application/json

OpenAPI: McpWalletBuySellBodyDto. GraphQL: WalletBuySellOperationArgs in apps/gql-main/src/wallet/args/walletOperation.args.ts.

​
amount
number
required

Amount for the operation

​
tokenMint
string

Token mint address (optional; defaults to SOL)

​
toAddress
string

Destination address (required for withdraw)

​
stopLoss
object

Optional stop-loss on the open BUY affected by this operation

​
takeProfit
object

Optional take-profit on the open BUY for this mint

Response

200 - application/json

Operation result.

​
success
boolean
required
Example:

true

​
data
object
required

Endpoint-specific payload