GET /symbols

/symbols turns a ticker into the full metadata payload the Charting Library needs to render a chart — session window, pricescale, timezone, supported resolutions, etc.

• Method: GET
• Path: /api/nepse/tradingview/symbols
• Content-Type: application/json

Query parameters

Input normalization:

1. Trim whitespace.
2. If a colon is present, keep only the portion after it (NEPSE:NABIL → NABIL, NEPSE:^NEPSE → ^NEPSE).
3. Upper-case the remainder. The ^ prefix survives both steps.

Symbol namespace

The ^ prefix is a finance-industry convention (Yahoo ^GSPC, ^IXIC) that can never collide with NEPSE company tickers because NEPSE tickers are uppercase letters/digits only. The backend stores the bare ticker in the nepse_indices.tv_symbol / nepse_sub_indices.tv_symbol columns; the ^ is reattached in every /symbols, /search, and /history round trip.

Both top-level and sector indices come back with type: "index" — the frontend can infer sector-ness from the symbol list if it cares, but the Charting Library treats them identically.

Success response

{
  "name": "NABIL",
  "ticker": "NABIL",
  "full_name": "NEPSE:NABIL",
  "description": "Nabil Bank Limited",
  "type": "stock",
  "session": "1100-1500:23456",
  "timezone": "Asia/Kathmandu",
  "exchange": "NEPSE",
  "listed_exchange": "NEPSE",
  "minmov": 1,
  "pricescale": 100,
  "has_intraday": true,
  "intraday_multipliers": ["1", "5", "15", "30", "60"],
  "has_daily": true,
  "has_weekly_and_monthly": true,
  "supported_resolutions": ["1", "5", "15", "30", "60", "1D", "1W", "1M"],
  "currency_code": "NPR",
  "data_status": "streaming",
  "volume_precision": 0
}

Session format

The session field encodes both trading hours and active weekdays.

"1100-1500:23456"
 │         │
 │         └─── day mask, UDF encoding: 1=Sun, 2=Mon, 3=Tue, 4=Wed, 5=Thu, 6=Fri, 7=Sat
 └──────────── HHMM-HHMM window

• NEPSE trades Monday–Friday, 11:00–15:00 NPT → 1100-1500:23456.
• If NEPSE had a pre-open slot you wanted visible on the chart, you'd use multi-segment form: "1030-1100,1100-1500:23456".
• The timezone field controls how the library interprets the HHMM values — so 1100-1500 here is 11:00 Asia/Kathmandu, not UTC.

Caching

Resolved symbols are cached in Redis for 5 minutes:

• Key: nepse:tv:symbol:<UPPER_SYMBOL> (constant + cache.NepseTVSymbolKey)
• TTL: cache.TTLNepseTVSymbol() = 5 minutes
• 404 responses are never cached — a company added later must resolve on next call.

Redis failure (read or write) is non-fatal — the service logs a warning and falls through to the DB. This means a Redis outage degrades latency, not availability.

Error responses

All errors follow the UDF shape {"s":"error","errmsg":"..."} — never an envelope, never HTML.

Prefix-stripping examples

Verification

# Full payload — verify new fields are present
curl -s "$BASE/symbols?symbol=NABIL" | jq \
  '{full_name, listed_exchange, session, intraday_multipliers, volume_precision}'

# Prefix stripping
curl -s "$BASE/symbols?symbol=NEPSE:NABIL" | jq '.ticker'
# "NABIL"

# Unknown
curl -sw "\n%{http_code}\n" "$BASE/symbols?symbol=ZZZZZ"
# {"errmsg":"unknown_symbol","s":"error"}
# 404

Implementation

• Handler: internal/modules/nepse/tradingview/handler.go → (*Handler).Symbols
• Service: internal/modules/nepse/tradingview/service.go → (*Service).ResolveSymbol, (*Service).resolve
• Type: internal/modules/nepse/tradingview/types.go → SymbolResponse
• sqlc: FindCompanyBySymbol (companies.sql), FindIndexByTVSymbol / FindSubIndexByTVSymbol (charts.sql)
• Cache key helpers: internal/platform/cache/keys.go → NepseTVSymbolKey, TTLNepseTVSymbol