Skip to main content
GET
/
api
/
symbols
/
<symbol>
Get Symbol Details
curl --request GET \
  --url 'https://api.example.com/api/symbols/<symbol>'
{
  "success": true,
  "data": {
    "symbol": "<string>",
    "summary": {},
    "trades": [
      {}
    ],
    "dividends": [
      {}
    ]
  },
  "data_source": "<string>"
}

​
Endpoint

GET /api/symbols/<symbol>

​
Authentication

Requires OAuth 2.0 authentication via session cookies.

​
Parameters

​
symbol
string
required
Stock ticker symbol (e.g., AAPL, TSLA)

​
Response

​
success
boolean
required
Indicates if the request was successful
​
data
object
required
Detailed symbol data
​
data_source
string
required
Database source (always “postgresql”)

​
Example

curl -X GET https://performance.miningwood.com/api/symbols/AAPL \
  -H "Cookie: session=your_session_cookie"

​
Response Example

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "summary": {
      "total_trades": 25,
      "trading_profit_loss": 3450.50,
      "winning_trades": 18,
      "win_rate_percentage": 72.0,
      "avg_profit_loss": 138.02,
      "min_profit_loss": -250.00,
      "max_profit_loss": 550.00,
      "avg_return_pct": 2.15,
      "min_return_pct": -3.5,
      "max_return_pct": 5.8,
      "avg_holding_days": 12,
      "total_volume": 2500,
      "total_cost_basis": 487500.00,
      "first_trade_date": "2024-01-15",
      "last_trade_date": "2024-08-30",
      "total_dividend_payments": 8,
      "total_dividends": 320.00,
      "avg_dividend_amount": 40.00,
      "first_dividend_date": "2024-02-15",
      "last_dividend_date": "2024-08-15",
      "total_return": 3770.50,
      "current_shares_held": 100
    },
    "trades": [
      {
        "buy_date": "2024-08-01",
        "sell_date": "2024-08-15",
        "buy_price": 195.50,
        "sell_price": 198.75,
        "volume": 100,
        "total_profit_loss": 325.00,
        "return_percentage": 1.66,
        "trade_result": "Win",
        "holding_days": 14
      }
    ],
    "dividends": [
      {
        "transaction_date": "2024-08-15",
        "action": "Cash Dividend",
        "amount": 40.00
      }
    ]
  },
  "data_source": "postgresql"
}

​
Summary Statistics

The summary object includes:
StatisticDescription
Trading MetricsTotal trades, winning trades, win rate, average P&L
Performance RangeMin/max profit loss and return percentages
Holding PatternAverage holding days
Volume & CostTotal volume traded and cost basis
Dividend IncomePayment count, total amount, average
Date RangeFirst and last trade/dividend dates
Current PositionShares currently held

​
Error Response

{
  "success": false,
  "error": "Symbol not found"
}
HTTP Status: 404 Not Found

Symbols Summary

Get summary stats for all symbols

Timeframe Data

Filter by date range and symbols