API Documentation — FinStack — Indian Financial Data API

Introduction

FinStack provides a simple REST API for Indian financial data. All responses are in JSON format and follow a consistent structure.

Base URL:

https://finstack.techietweetz.com/api/v1

Response format (all endpoints):

{ "success": true, "message": "...", "data": { /* endpoint data */ }, "timestamp": "2024-01-15T10:30:00+05:30" }

Authentication

Every request must include your API key. Pass it as a request header (recommended) or as a query parameter.

Option 1 — Header (Recommended)

curl -H "X-API-Key: fsk_live_your_key_here" \
     https://finstack.techietweetz.com/api/v1/crypto/BTC

Option 2 — Query Parameter

https://finstack.techietweetz.com/api/v1/crypto/BTC?api_key=fsk_live_your_key_here

Your API key is available in your dashboard after registration.

Rate Limits

Limits vary by plan. Every response includes rate limit headers:

X-RateLimit-Limit-Day: 500 X-RateLimit-Remaining-Day: 487 X-RateLimit-Limit-Minute: 10 X-RateLimit-Remaining-Minute: 9

Plan	Daily Limit	Per Minute	Data
Free	500	10	15 min delayed
Starter	50,000	60	Real-time
Pro	5,00,000	300	Real-time
Business	Unlimited	1,000	Real-time

Error Codes

MISSING_API_KEY

401 No API key provided in header or query param

INVALID_API_KEY

401 API key is invalid, inactive or expired

ACCOUNT_SUSPENDED

403 Your account has been suspended

DAILY_LIMIT_EXCEEDED

429 You have used up your daily API call quota

RATE_LIMIT_EXCEEDED

429 Too many requests per minute

NOT_FOUND

404 Requested resource (coin, currency, bank) not found

DATA_UNAVAILABLE

503 Data not available yet, cron may not have run

ENDPOINT_NOT_FOUND

404 API endpoint URL does not exist

Commodities

GET /api/v1/commodities

Returns gold (24K + 22K) and silver prices in one call.

GET /api/v1/commodities/gold

Returns 24K and 22K gold prices in INR.

{ "gold_24k": { "label": "24 Karat Gold", "price_per_gram": 7420.50, "price_per_10gram": 74205.00, "price_per_tola": 86563.48, "currency": "INR", "city": "Mumbai", "date": "2024-01-15" }, "gold_22k": { /* same structure */ } }

GET /api/v1/commodities/silver

Returns silver price per gram, 10g and tola.

Crypto

GET /api/v1/crypto

Returns top 20 cryptocurrencies priced in INR.

Parameter	Type	Default	Description
`per_page`	integer	20	Results per page (max 50)
`page`	integer	1	Page number

GET /api/v1/crypto/{symbol}

Returns a single coin. Use uppercase symbol: BTC, ETH, SOL

{ "symbol": "BTC", "name": "Bitcoin", "price_inr": 6842350.00, "price_usd": 81950.00, "market_cap_inr": 135420000000000, "change_24h": 2.34, "change_7d": -1.12, "last_updated": "2024-01-15T10:20:00+05:30" }

Forex

GET /api/v1/forex

Returns 20 currency pairs against INR.

GET /api/v1/forex/{currency}

Single currency pair. Examples: USD, EUR, GBP, AED

{ "currency": "USD", "rate_per_inr": 0.011976, "inr_per_unit": 83.50, "pair": "INR/USD", "date": "2024-01-15" }

Mutual Funds

GET /api/v1/mutual-funds

Paginated list of all mutual fund schemes with latest NAV.

Parameter	Type	Description
`per_page`	integer	Results per page (max 100, default 20)
`page`	integer	Page number
`category`	string	Equity, Debt, Hybrid, ELSS, Index, Liquid
`fund_house`	string	Filter by fund house name (partial match)
`date`	date	NAV date (YYYY-MM-DD). Defaults to latest.

GET /api/v1/mutual-funds/search?q=hdfc+midcap

Search schemes by name, fund house or scheme code. Minimum 3 characters.

GET /api/v1/mutual-funds/{scheme_code}

Single scheme with latest NAV + 30-day history. Example: 120503

{ "scheme_code": "120503", "scheme_name": "HDFC Mid-Cap Opportunities Fund", "fund_house": "HDFC Mutual Fund", "scheme_category": "Equity", "nav": 142.53, "nav_date": "2024-01-15", "history": [ { "date": "2024-01-15", "nav": 142.53 }, { "date": "2024-01-14", "nav": 141.20 } ] }

FD Rates

GET /api/v1/fd-rates

Parameter	Type	Description
`bank_type`	string	public, private, small_finance
`tenure`	integer	Filter by tenure in days (e.g. 365)

GET /api/v1/fd-rates/{bank}

FD rates for a specific bank. Example: hdfc, sbi, icici

{ "bank_name": "HDFC Bank", "bank_type": "private", "fd_rates": [ { "tenure_label": "1 Year", "rate_general": 6.60, "rate_senior": 7.10, "effective_date":"2024-01-01" } ] }

PHP Example

$apiKey = 'fsk_live_your_key_here';

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => 'https://finstack.techietweetz.com/api/v1/crypto/BTC',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["X-API-Key: $apiKey"],
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $response['data']['price_inr']; // 6842350.00

JavaScript Example

const response = await fetch(
  'https://finstack.techietweetz.com/api/v1/crypto/BTC',
  { headers: { 'X-API-Key': 'fsk_live_your_key_here' } }
);

const data = await response.json();
console.log(data.data.price_inr); // 6842350.00

Python Example

import requests

headers  = {"X-API-Key": "fsk_live_your_key_here"}
response = requests.get(
    "https://finstack.techietweetz.com/api/v1/crypto/BTC",
    headers=headers
)

data = response.json()
print(data["data"]["price_inr"])  # 6842350.00

Ready to Start?

Get your free API key in 2 minutes. 500 calls/day, no credit card needed.

Get Free API Key