Placing trades

You trade by telling the API which of your wallets, which token and how much. The platform finds the venue, builds and signs the transaction with that wallet, and submits it — the same path as pressing Buy on the dashboard. You never sign anything yourself, and there is no endpoint for submitting a transaction you signed elsewhere.

The network follows the wallet: a Solana wallet trades on Solana, a Robinhood Chain wallet on Robinhood Chain. Get your wallet addresses from GET /wallets (Authentication).

Buying

curl -s -X POST "$NEURO_API/tradings/buy" \
  -H "Authorization: Bearer $NEURO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "walletAddress": "7xKX...yourWallet",
        "tokenAddress": "Bp8m...pump",
        "amount": 0.1,
        "slippage": 15
      }'

Anything you leave out comes from your account’s trading settings (Settings → Fee & Slippage on the dashboard, config.trading on GET /user). Values you send apply to this trade only and do not change your settings.

Selling

A sell is sized as a percentage of what the wallet holds of that token, so you do not need to know the exact balance:

curl -s -X POST "$NEURO_API/tradings/sell" \
  -H "Authorization: Bearer $NEURO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "walletAddress": "7xKX...yourWallet",
        "tokenAddress": "Bp8m...pump",
        "amount": 50
      }'

Selling 100% also cancels that token’s take-profit, stop-loss and other pending orders.

Selling everything

POST /tradings/sell-all sells 100% of every token held across your active wallets, as a background job:

curl -s -X POST "$NEURO_API/tradings/sell-all" \
  -H "Authorization: Bearer $NEURO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "slippage": 20 }'
# → { "data": { "jobId": "0f5c2a6e-..." } }

It accepts slippage, priorityLevel and shouldValidateBalance. Follow the job with GET /tradings/sell-all/<jobId>/status, which reports status (pending, running, completed, failed), total, processed, and the results and errors per position. POST /tradings/sell-all/<jobId>/cancel stops it before the remaining sells go out.

What comes back

Solana

A Solana buy or sell answers as soon as the transaction is submitted, not when it is confirmed:

{
  "code": 200,
  "message": "Success",
  "data": {
    "txId": "5h3Y...signature",
    "tokenSymbol": "EXM",
    "solAmount": 0.1,
    "tokenAmount": 2427184.4,
    "marketCap": 7360.11
  }
}

txId is the transaction signature. The amounts are estimates made at submission. A sell also returns amountSoldInPercentage, and where available usdValue and solPriceInUsd.

To confirm, poll GET /tradings/<txId>/status every second or two:

{ "code": 200, "message": "Success", "data": { "status": "pending" } }

status is pending, success or failed. A failed transaction also carries onChainError. For the settled amounts — what you actually paid and received, net of fees — read the trade from your history once it is confirmed.

EVM networks

An EVM buy or sell waits for the network to confirm, and returns the result under data.evm:

{
  "code": 200,
  "message": "Success",
  "data": {
    "txId": "0x9a1f...",
    "tokenSymbol": "EXM",
    "evm": {
      "chainId": 4663,
      "side": "BUY",
      "txHash": "0x9a1f...",
      "txHashes": ["0x9a1f..."],
      "tokenAddress": "0x6e2c...a41f",
      "tokenDecimals": 18,
      "tokenAmount": "43290043290043290043290",
      "payAsset": { "address": "0x...", "symbol": "ETH", "decimals": 18, "isNative": true },
      "payAmount": "100000000000000000",
      "platformFee": "1000000000000000",
      "referralFee": "0",
      "gasFee": "21000000000000",
      "priceUsd": 0.0000071
    }
  }
}

EVM amounts are strings in base units — divide by 10^tokenDecimals (or 10^payAsset.decimals) for whole units. payAsset names what was paid; it is not always ETH.

If the network has not confirmed by the end of the request, evm.status is "PENDING" and the amounts are "0". The trade settles in the background; check it in your EVM trade history.

Trade history

# Solana trades, newest first
curl -s "$NEURO_API/tradings?page=1&limit=20&walletAddress=7xKX...yourWallet" \
  -H "Authorization: Bearer $NEURO_TOKEN"
 
# EVM trades on Robinhood Chain
curl -s "$NEURO_API/tradings/evm/trades?chainId=4663" \
  -H "Authorization: Bearer $NEURO_TOKEN"

GET /tradings filters by type (BUY or SELL), walletAddress, page, limit and excludeFailed=true. Each row has txHash, status (PENDING, COMPLETED or FAILED), amount (SOL), tokenAmount, price and, for a failed trade, failedReason.

GET /tradings answers { data, total, totalPages }.

Positions and PnL

Each tokens-pnl row has the token’s balance, its value now (balanceInSOL, balanceInUSD), what you put in and took out (solSpent, solEarned), and pnlInSOL, pnlInUSD and pnlPercentage. A position you have just bought shows a small loss straight away: it is valued at what selling it now would return, after price impact.

The EVM position has realizedPnl and unrealizedPnl in base units of payAsset, with USD equivalents and pnlPercent.

/realized-pnl and the EVM summary count closed positions only. Half of a position that you have sold shows in the per-token and per-position PnL, not in these totals, until the position is fully closed.

Common errors

Fees

A real trade pays the platform’s trading fee for your plan, plus network costs — the priority fee or Jito tip on Solana, gas on EVM networks. Trades placed through the API are charged the same as trades placed by hand. Paper trades pay nothing.