API Docs | Xaro

▶ POST /full-text-search Keyword search with snippets AUTH

Param	Type	Required	Description
`query`	string	Yes	Search query. Supports FTS5: `OR`, quoted phrases, prefix*
`ticker`	string	No	NSE symbol (e.g. `RELIANCE`)
`type`	string	No	`annual_report`, `quarterly_result`, `other`
`year`	integer	No	Filter by filing year
`quarter`	integer	No	1-4
`sector`	string	No	Sector or industry name
`page`	integer	No	Page number (default: 1)
`limit`	integer	No	1-100 (default: 20)
`snippet_tokens`	integer	No	16-128 (default: 64)

curl -X POST https://xaro.ai/full-text-search \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "\"import duty\" OR \"customs duty\"", "sector": "Automobile and Auto Components", "limit": 5}'

▶ POST /embeddings-search Semantic search via AI embeddings AUTH

Param	Type	Required	Description
`query`	string	Yes	Natural language query
`ticker`	string	No	NSE symbol filter
`type`	string	No	Filing type filter
`year`	integer	No	Year filter
`quarter`	integer	No	1-4
`sector`	string	No	Sector or industry
`topK`	integer	No	1-100 (default: 20)

curl -X POST https://xaro.ai/embeddings-search \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "companies affected by EV policy changes", "topK": 10}'

▶ POST /multi-search Batch queries with company dedup AUTH

Run multiple FTS + semantic queries in one call. Results aggregated and ranked by company.

Param	Type	Required	Description
`queries`	array	Yes	Up to 50 query objects. Each: `query`, `type` (fts\|semantic), optional filters
`topK`	integer	No	Max companies, 1-200 (default: 50)
`min_matches`	integer	No	Min query matches per company (default: 1)

curl -X POST https://xaro.ai/multi-search \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [
      {"query": "\"import duty\"", "type": "fts", "sector": "Automobile and Auto Components"},
      {"query": "trade policy impact on margins", "type": "semantic"}
    ],
    "topK": 20
  }'

▶ GET /insider-trades PIT/SAST disclosures AUTH

SEBI insider trading disclosures from NSE. Filter by ticker, transaction type, person category, date range, and minimum value.

Param	Type	Description
`ticker`	string	NSE symbol (e.g. RELIANCE)
`transaction_type`	string	Buy, Sell, or Pledge
`person_category`	string	e.g. Promoters, Director, Key Managerial Personnel
`from`	string	Start date (YYYY-MM-DD)
`to`	string	End date (YYYY-MM-DD)
`min_value`	number	Min transaction value in INR
`page`	integer	Page number (default 1)
`limit`	integer	1-100 (default 20)

curl "https://xaro.ai/insider-trades?ticker=RELIANCE&transaction_type=Buy" \
  -H "X-Api-Key: YOUR_KEY"

▶ GET /insider-trades/top Largest trades by value AUTH

Returns the biggest insider trades ranked by transaction value. Filter by recency and transaction type.

Param	Type	Description
`days`	integer	Lookback in days (default 30, max 365)
`transaction_type`	string	Buy, Sell, or Pledge
`limit`	integer	1-100 (default 20)

curl "https://xaro.ai/insider-trades/top?days=90&transaction_type=Buy&limit=10" \
  -H "X-Api-Key: YOUR_KEY"

▶ GET /insider-trades/summary Net insider buy/sell per company AUTH

Aggregated insider activity: total buy/sell value, share counts, unique insiders. Ranked by net buy-sell value.

Param	Type	Description
`ticker`	string	NSE symbol (optional, omit for all companies)
`days`	integer	Lookback in days (default 90, max 365)

curl "https://xaro.ai/insider-trades/summary?days=90" \
  -H "X-Api-Key: YOUR_KEY"

▶ GET /stats Corpus overview AUTH 1HR

Returns filing counts, company counts, breakdowns by sector, type, and year.

curl https://xaro.ai/stats -H "X-Api-Key: YOUR_KEY"

▶ GET /companies/:ticker Company lookup AUTH

Returns company name, sector, industry, ISIN, filing counts by type.

curl https://xaro.ai/companies/INFY -H "X-Api-Key: YOUR_KEY"

▶ GET /sectors All sectors with counts AUTH 24HR

All 22 NSE sectors with company and filing counts. Use these as sector filter values.

curl https://xaro.ai/sectors -H "X-Api-Key: YOUR_KEY"

▶ GET /health Health check (no auth)

curl https://xaro.ai/health
# {"status":"ok"}

API Reference