STONKTRADERDEVELOPER

Quick start

Make your first public and authenticated StonkTrader API calls.

The production base URL is:

https://api.stonktrader.finance

All JSON responses use the same envelope:

{
  "code": 0,
  "message": "ok",
  "data": {}
}

1. Verify the service

curl https://api.stonktrader.finance/health/ready

A ready deployment returns HTTP 200 when its required services are available.

2. Discover login methods

curl https://api.stonktrader.finance/auth/methods

Choose a StonkTrader platform access token or the SIWE wallet flow described in the authentication guide.

3. Call the current-user API

After platform login, send the current short-lived access token:

curl https://api.stonktrader.finance/user \
  -H "Authorization: Bearer $STONKTRADER_ACCESS_TOKEN"

4. Save a watchlist item

curl https://api.stonktrader.finance/watchlist \
  -X POST \
  -H "Authorization: Bearer $STONKTRADER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "type": "COIN",
    "targetKey": "NVDA",
    "displayName": "NVIDIA"
  }'

5. Read a public quote

curl "https://api.stonktrader.finance/markets/quotes?symbols=NVDA,AAPL"

Use the interactive reference to inspect schemas and execute public requests from the browser.

On this page