API Reference

RESTful API access for Institutional subscribers ($999/month). Programmatic access to signals, screening data, and portfolio analytics.

Base URL

https://api.nucoresys.com/v1

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API keys are issued to Institutional subscribers via the account dashboard. Keys can be rotated at any time. Contact tech@nucoresys.com if you need to revoke a key immediately.

Rate Limits

• 1,000 requests per hour per API key
• Rate limit headers are included in every response
• Contact support to discuss higher rate limits for specific use cases

Endpoints

GET /signals

Returns the latest daily signals for all stocks in the current ethical universe.

GET /v1/signals
GET /v1/signals?direction=BUY
GET /v1/signals?ticker=MSFT

Response fields: ticker, direction, composite_score, confidence, generated_at

GET /screening/{ticker}

Returns the current ethical screening status and factor values for a specific ticker.

GET /v1/screening/AAPL

Response fields: ticker, pass, business_activity_pass, revenue_purity_pct, revenue_purity_pass, debt_ratio_pct, debt_ratio_pass, interest_income_pct, interest_income_pass, screened_at

GET /universe

Returns the full list of tickers currently passing all four ethical screening layers.

GET /v1/universe

GET /charitable/{ticker}

Returns the current impermissible revenue percentage for charitable allocation calculations.

GET /v1/charitable/AAPL

Webhooks

Institutional subscribers can register webhook endpoints to receive real-time notifications:

• signal.new — New signal generated for a ticker
• signal.changed — Signal direction changed for a ticker
• screening.failed — A ticker failed a screening layer
• screening.reinstated — A ticker re-passed all screening layers

Register webhooks via the account dashboard or contact tech@nucoresys.com.

Support

API technical support: tech@nucoresys.com (4-hour SLA for Institutional subscribers)