Skip to main content
POST
/
api
/
v2
/
agents
/
suggestions
cURL
curl --request POST \
  --url https://api.shuriken.trade/api/v2/agents/suggestions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset": "<string>",
  "networkId": "<string>",
  "rationale": "<string>",
  "side": "<string>",
  "amountInUsd": 123,
  "confidence": "<string>"
}
'
{
  "data": {
    "agentKey": {
      "id": "<string>",
      "name": "<string>"
    },
    "asset": {
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "priceUsd": 123
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "expiresAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "networkId": "<string>",
    "rationale": "<string>",
    "side": "<string>",
    "state": "OPEN",
    "actedAt": "2023-11-07T05:31:56Z",
    "amountInUsd": 123,
    "confidence": "<string>",
    "dismissReason": "<string>",
    "dismissedAt": "2023-11-07T05:31:56Z",
    "linkedTaskId": "<string>"
  },
  "requestId": "<string>",
  "pagination": {
    "hasMore": true,
    "limit": 1,
    "page": 1,
    "total": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.shuriken.trade/llms.txt

Use this file to discover all available pages before exploring further.

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

Page-based pagination info (per RFC)