{
"metadata": {
"name": "dreammaker_free_api_registry",
"version": "2025.11.11",
"description": "Merged registry of uploaded crypto resources (TXT and ZIP). Contains raw file text, ZIP listing, discovered keys, and basic categorization scaffold.",
"created_at": "2025-11-10T22:20:17.449681",
"source_files": [
"api-config-complete (1).txt",
"api - Copy.txt",
"crypto_resources_ultimate_2025.zip"
]
},
"raw_files": [
{
"filename": "api-config-complete (1).txt",
"content": "╔══════════════════════════════════════════════════════════════════════════════════════╗\n║ CRYPTOCURRENCY API CONFIGURATION - COMPLETE GUIDE ║\n║ تنظیمات کامل API های ارز دیجیتال ║\n║ Updated: October 2025 ║\n╚══════════════════════════════════════════════════════════════════════════════════════╝\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 🔑 API KEYS - کلیدهای API \n═══════════════════════════════════════════════════════════════════════════════════════\n\nEXISTING KEYS (کلیدهای موجود):\n─────────────────────────────────\nTronScan: 7ae72726-bffe-4e74-9c33-97b761eeea21\nBscScan: K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT\nEtherscan: SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2\nEtherscan_2: T6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45\nCoinMarketCap: 04cf4b5b-9868-465c-8ba0-9f2e78c92eb1\nCoinMarketCap_2: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c\nNewsAPI: pub_346789abc123def456789ghi012345jkl\nCryptoCompare: e79c8e6d4c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 🌐 CORS PROXY SOLUTIONS - راهحلهای پروکسی CORS\n═══════════════════════════════════════════════════════════════════════════════════════\n\nFREE CORS PROXIES (پروکسیهای رایگان):\n──────────────────────────────────────────\n\n1. AllOrigins (بدون محدودیت)\n URL: https://api.allorigins.win/get?url={TARGET_URL}\n Example: https://api.allorigins.win/get?url=https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd\n Features: JSON/JSONP, گزینه raw content\n \n2. CORS.SH (بدون rate limit)\n URL: https://proxy.cors.sh/{TARGET_URL}\n Example: https://proxy.cors.sh/https://api.coinmarketcap.com/v1/cryptocurrency/quotes/latest\n Features: سریع، قابل اعتماد، نیاز به header Origin یا x-requested-with\n \n3. Corsfix (60 req/min رایگان)\n URL: https://proxy.corsfix.com/?url={TARGET_URL}\n Example: https://proxy.corsfix.com/?url=https://api.etherscan.io/api\n Features: header override، cached responses\n \n4. CodeTabs (محبوب)\n URL: https://api.codetabs.com/v1/proxy?quest={TARGET_URL}\n Example: https://api.codetabs.com/v1/proxy?quest=https://api.binance.com/api/v3/ticker/price\n \n5. ThingProxy (10 req/sec)\n URL: https://thingproxy.freeboard.io/fetch/{TARGET_URL}\n Example: https://thingproxy.freeboard.io/fetch/https://api.nomics.com/v1/currencies/ticker\n Limit: 100,000 characters per request\n \n6. Crossorigin.me\n URL: https://crossorigin.me/{TARGET_URL}\n Note: فقط GET، محدودیت 2MB\n \n7. Self-Hosted CORS-Anywhere\n GitHub: https://github.com/Rob--W/cors-anywhere\n Deploy: Cloudflare Workers، Vercel، Heroku\n\nUSAGE PATTERN (الگوی استفاده):\n────────────────────────────────\n// Without CORS Proxy\nfetch('https://api.example.com/data')\n\n// With CORS Proxy\nconst corsProxy = 'https://api.allorigins.win/get?url=';\nfetch(corsProxy + encodeURIComponent('https://api.example.com/data'))\n .then(res => res.json())\n .then(data => console.log(data.contents));\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 🔗 RPC NODE PROVIDERS - ارائهدهندگان نود RPC\n═══════════════════════════════════════════════════════════════════════════════════════\n\nETHEREUM RPC ENDPOINTS:\n───────────────────────────────────\n\n1. Infura (رایگان: 100K req/day)\n Mainnet: https://mainnet.infura.io/v3/{PROJECT_ID}\n Sepolia: https://sepolia.infura.io/v3/{PROJECT_ID}\n Docs: https://docs.infura.io\n \n2. Alchemy (رایگان: 300M compute units/month)\n Mainnet: https://eth-mainnet.g.alchemy.com/v2/{API_KEY}\n Sepolia: https://eth-sepolia.g.alchemy.com/v2/{API_KEY}\n WebSocket: wss://eth-mainnet.g.alchemy.com/v2/{API_KEY}\n Docs: https://docs.alchemy.com\n \n3. Ankr (رایگان: بدون محدودیت عمومی)\n Mainnet: https://rpc.ankr.com/eth\n Docs: https://www.ankr.com/docs\n \n4. PublicNode (کاملا رایگان)\n Mainnet: https://ethereum.publicnode.com\n All-in-one: https://ethereum-rpc.publicnode.com\n \n5. Cloudflare (رایگان)\n Mainnet: https://cloudflare-eth.com\n \n6. LlamaNodes (رایگان)\n Mainnet: https://eth.llamarpc.com\n \n7. 1RPC (رایگان با privacy)\n Mainnet: https://1rpc.io/eth\n \n8. Chainnodes (ارزان)\n Mainnet: https://mainnet.chainnodes.org/{API_KEY}\n \n9. dRPC (decentralized)\n Mainnet: https://eth.drpc.org\n Docs: https://drpc.org\n\nBSC (BINANCE SMART CHAIN) RPC:\n──────────────────────────────────\n\n1. Official BSC RPC (رایگان)\n Mainnet: https://bsc-dataseed.binance.org\n Alt1: https://bsc-dataseed1.defibit.io\n Alt2: https://bsc-dataseed1.ninicoin.io\n \n2. Ankr BSC\n Mainnet: https://rpc.ankr.com/bsc\n \n3. PublicNode BSC\n Mainnet: https://bsc-rpc.publicnode.com\n \n4. Nodereal BSC (رایگان: 3M req/day)\n Mainnet: https://bsc-mainnet.nodereal.io/v1/{API_KEY}\n\nTRON RPC ENDPOINTS:\n───────────────────────────\n\n1. TronGrid (رایگان)\n Mainnet: https://api.trongrid.io\n Full Node: https://api.trongrid.io/wallet/getnowblock\n \n2. TronStack (رایگان)\n Mainnet: https://api.tronstack.io\n \n3. Nile Testnet\n Testnet: https://api.nileex.io\n\nPOLYGON RPC:\n──────────────────\n\n1. Polygon Official (رایگان)\n Mainnet: https://polygon-rpc.com\n Mumbai: https://rpc-mumbai.maticvigil.com\n \n2. Ankr Polygon\n Mainnet: https://rpc.ankr.com/polygon\n \n3. Alchemy Polygon\n Mainnet: https://polygon-mainnet.g.alchemy.com/v2/{API_KEY}\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 📊 BLOCK EXPLORER APIs - APIهای کاوشگر بلاکچین\n═══════════════════════════════════════════════════════════════════════════════════════\n\nCATEGORY 1: ETHEREUM EXPLORERS (11 endpoints)\n──────────────────────────────────────────────\n\nPRIMARY: Etherscan\n─────────────────────\nURL: https://api.etherscan.io/api\nKey: SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2\nRate Limit: 5 calls/sec (free tier)\nDocs: https://docs.etherscan.io\n\nEndpoints:\n• Balance: ?module=account&action=balance&address={address}&tag=latest&apikey={KEY}\n• Transactions: ?module=account&action=txlist&address={address}&startblock=0&endblock=99999999&sort=asc&apikey={KEY}\n• Token Balance: ?module=account&action=tokenbalance&contractaddress={contract}&address={address}&tag=latest&apikey={KEY}\n• Gas Price: ?module=gastracker&action=gasoracle&apikey={KEY}\n\nExample (No Proxy):\nfetch('https://api.etherscan.io/api?module=account&action=balance&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb&tag=latest&apikey=SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2')\n\nExample (With CORS Proxy):\nconst proxy = 'https://api.allorigins.win/get?url=';\nconst url = 'https://api.etherscan.io/api?module=account&action=balance&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb&apikey=SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2';\nfetch(proxy + encodeURIComponent(url))\n .then(r => r.json())\n .then(data => {\n const result = JSON.parse(data.contents);\n console.log('Balance:', result.result / 1e18, 'ETH');\n });\n\nFALLBACK 1: Etherscan (Second Key)\n────────────────────────────────────\nURL: https://api.etherscan.io/api\nKey: T6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45\n\nFALLBACK 2: Blockchair\n──────────────────────\nURL: https://api.blockchair.com/ethereum/dashboards/address/{address}\nFree: 1,440 requests/day\nDocs: https://blockchair.com/api/docs\n\nFALLBACK 3: BlockScout (Open Source)\n─────────────────────────────────────\nURL: https://eth.blockscout.com/api\nFree: بدون محدودیت\nDocs: https://docs.blockscout.com\n\nFALLBACK 4: Ethplorer\n──────────────────────\nURL: https://api.ethplorer.io\nEndpoint: /getAddressInfo/{address}?apiKey=freekey\nFree: محدود\nDocs: https://github.com/EverexIO/Ethplorer/wiki/Ethplorer-API\n\nFALLBACK 5: Etherchain\n──────────────────────\nURL: https://www.etherchain.org/api\nFree: بله\nDocs: https://www.etherchain.org/documentation/api\n\nFALLBACK 6: Chainlens\n─────────────────────\nURL: https://api.chainlens.com\nFree tier available\nDocs: https://docs.chainlens.com\n\n\nCATEGORY 2: BSC EXPLORERS (6 endpoints)\n────────────────────────────────────────\n\nPRIMARY: BscScan\n────────────────\nURL: https://api.bscscan.com/api\nKey: K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT\nRate Limit: 5 calls/sec\nDocs: https://docs.bscscan.com\n\nEndpoints:\n• BNB Balance: ?module=account&action=balance&address={address}&apikey={KEY}\n• BEP-20 Balance: ?module=account&action=tokenbalance&contractaddress={token}&address={address}&apikey={KEY}\n• Transactions: ?module=account&action=txlist&address={address}&apikey={KEY}\n\nExample:\nfetch('https://api.bscscan.com/api?module=account&action=balance&address=0x1234...&apikey=K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT')\n .then(r => r.json())\n .then(data => console.log('BNB:', data.result / 1e18));\n\nFALLBACK 1: BitQuery (BSC)\n──────────────────────────\nURL: https://graphql.bitquery.io\nMethod: GraphQL POST\nFree: 10K queries/month\nDocs: https://docs.bitquery.io\n\nGraphQL Example:\nquery {\n ethereum(network: bsc) {\n address(address: {is: \"0x...\"}) {\n balances {\n currency { symbol }\n value\n }\n }\n }\n}\n\nFALLBACK 2: Ankr MultiChain\n────────────────────────────\nURL: https://rpc.ankr.com/multichain\nMethod: JSON-RPC POST\nFree: Public endpoints\nDocs: https://www.ankr.com/docs/\n\nFALLBACK 3: Nodereal BSC\n────────────────────────\nURL: https://bsc-mainnet.nodereal.io/v1/{API_KEY}\nFree tier: 3M requests/day\nDocs: https://docs.nodereal.io\n\nFALLBACK 4: BscTrace\n────────────────────\nURL: https://api.bsctrace.com\nFree: Limited\nAlternative explorer\n\nFALLBACK 5: 1inch BSC API\n─────────────────────────\nURL: https://api.1inch.io/v5.0/56\nFree: For trading data\nDocs: https://docs.1inch.io\n\n\nCATEGORY 3: TRON EXPLORERS (5 endpoints)\n─────────────────────────────────────────\n\nPRIMARY: TronScan\n─────────────────\nURL: https://apilist.tronscanapi.com/api\nKey: 7ae72726-bffe-4e74-9c33-97b761eeea21\nRate Limit: Varies\nDocs: https://github.com/tronscan/tronscan-frontend/blob/dev2019/document/api.md\n\nEndpoints:\n• Account: /account?address={address}\n• Transactions: /transaction?address={address}&limit=20\n• TRC20 Transfers: /token_trc20/transfers?address={address}\n• Account Resources: /account/detail?address={address}\n\nExample:\nfetch('https://apilist.tronscanapi.com/api/account?address=TxxxXXXxxx')\n .then(r => r.json())\n .then(data => console.log('TRX Balance:', data.balance / 1e6));\n\nFALLBACK 1: TronGrid (Official)\n────────────────────────────────\nURL: https://api.trongrid.io\nFree: Public\nDocs: https://developers.tron.network/docs\n\nJSON-RPC Example:\nfetch('https://api.trongrid.io/wallet/getaccount', {\n method: 'POST',\n headers: {'Content-Type': 'application/json'},\n body: JSON.stringify({\n address: 'TxxxXXXxxx',\n visible: true\n })\n})\n\nFALLBACK 2: Tron Official API\n──────────────────────────────\nURL: https://api.tronstack.io\nFree: Public\nDocs: Similar to TronGrid\n\nFALLBACK 3: Blockchair (TRON)\n──────────────────────────────\nURL: https://api.blockchair.com/tron/dashboards/address/{address}\nFree: 1,440 req/day\nDocs: https://blockchair.com/api/docs\n\nFALLBACK 4: Tronscan API v2\n───────────────────────────\nURL: https://api.tronscan.org/api\nAlternative endpoint\nSimilar structure\n\nFALLBACK 5: GetBlock TRON\n─────────────────────────\nURL: https://go.getblock.io/tron\nFree tier available\nDocs: https://getblock.io/docs/\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 💰 MARKET DATA APIs - APIهای دادههای بازار\n═══════════════════════════════════════════════════════════════════════════════════════\n\nCATEGORY 1: PRICE & MARKET CAP (15+ endpoints)\n───────────────────────────────────────────────\n\nPRIMARY: CoinGecko (FREE - بدون کلید)\n──────────────────────────────────────\nURL: https://api.coingecko.com/api/v3\nRate Limit: 10-50 calls/min (free)\nDocs: https://www.coingecko.com/en/api/documentation\n\nBest Endpoints:\n• Simple Price: /simple/price?ids=bitcoin,ethereum&vs_currencies=usd\n• Coin Data: /coins/{id}?localization=false\n• Market Chart: /coins/{id}/market_chart?vs_currency=usd&days=7\n• Global Data: /global\n• Trending: /search/trending\n• Categories: /coins/categories\n\nExample (Works Everywhere):\nfetch('https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,tron&vs_currencies=usd,eur')\n .then(r => r.json())\n .then(data => console.log(data));\n// Output: {bitcoin: {usd: 45000, eur: 42000}, ...}\n\nFALLBACK 1: CoinMarketCap (با کلید)\n─────────────────────────────────────\nURL: https://pro-api.coinmarketcap.com/v1\nKey 1: b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c\nKey 2: 04cf4b5b-9868-465c-8ba0-9f2e78c92eb1\nRate Limit: 333 calls/day (free)\nDocs: https://coinmarketcap.com/api/documentation/v1/\n\nEndpoints:\n• Latest Quotes: /cryptocurrency/quotes/latest?symbol=BTC,ETH\n• Listings: /cryptocurrency/listings/latest?limit=100\n• Market Pairs: /cryptocurrency/market-pairs/latest?id=1\n\nExample (Requires API Key in Header):\nfetch('https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest?symbol=BTC', {\n headers: {\n 'X-CMC_PRO_API_KEY': 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c'\n }\n})\n.then(r => r.json())\n.then(data => console.log(data.data.BTC));\n\nWith CORS Proxy:\nconst proxy = 'https://proxy.cors.sh/';\nfetch(proxy + 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest?symbol=BTC', {\n headers: {\n 'X-CMC_PRO_API_KEY': 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c',\n 'Origin': 'https://myapp.com'\n }\n})\n\nFALLBACK 2: CryptoCompare\n─────────────────────────\nURL: https://min-api.cryptocompare.com/data\nKey: e79c8e6d4c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f\nFree: 100K calls/month\nDocs: https://min-api.cryptocompare.com/documentation\n\nEndpoints:\n• Price Multi: /pricemulti?fsyms=BTC,ETH&tsyms=USD,EUR&api_key={KEY}\n• Historical: /v2/histoday?fsym=BTC&tsym=USD&limit=30&api_key={KEY}\n• Top Volume: /top/totalvolfull?limit=10&tsym=USD&api_key={KEY}\n\nFALLBACK 3: Coinpaprika (FREE)\n───────────────────────────────\nURL: https://api.coinpaprika.com/v1\nRate Limit: 20K calls/month\nDocs: https://api.coinpaprika.com/\n\nEndpoints:\n• Tickers: /tickers\n• Coin: /coins/btc-bitcoin\n• Historical: /coins/btc-bitcoin/ohlcv/historical\n\nFALLBACK 4: CoinCap (FREE)\n──────────────────────────\nURL: https://api.coincap.io/v2\nRate Limit: 200 req/min\nDocs: https://docs.coincap.io/\n\nEndpoints:\n• Assets: /assets\n• Specific: /assets/bitcoin\n• History: /assets/bitcoin/history?interval=d1\n\nFALLBACK 5: Nomics (FREE)\n─────────────────────────\nURL: https://api.nomics.com/v1\nNo Rate Limit on free tier\nDocs: https://p.nomics.com/cryptocurrency-bitcoin-api\n\nFALLBACK 6: Messari (FREE)\n──────────────────────────\nURL: https://data.messari.io/api/v1\nRate Limit: Generous\nDocs: https://messari.io/api/docs\n\nFALLBACK 7: CoinLore (FREE)\n───────────────────────────\nURL: https://api.coinlore.net/api\nRate Limit: None\nDocs: https://www.coinlore.com/cryptocurrency-data-api\n\nFALLBACK 8: Binance Public API\n───────────────────────────────\nURL: https://api.binance.com/api/v3\nFree: بله\nDocs: https://binance-docs.github.io/apidocs/spot/en/\n\nEndpoints:\n• Price: /ticker/price?symbol=BTCUSDT\n• 24hr Stats: /ticker/24hr?symbol=ETHUSDT\n\nFALLBACK 9: CoinDesk API\n────────────────────────\nURL: https://api.coindesk.com/v1\nFree: Bitcoin price index\nDocs: https://www.coindesk.com/coindesk-api\n\nFALLBACK 10: Mobula API\n───────────────────────\nURL: https://api.mobula.io/api/1\nFree: 50% cheaper than CMC\nCoverage: 2.3M+ cryptocurrencies\nDocs: https://developer.mobula.fi/\n\nFALLBACK 11: Token Metrics API\n───────────────────────────────\nURL: https://api.tokenmetrics.com/v2\nFree API key available\nAI-driven insights\nDocs: https://api.tokenmetrics.com/docs\n\nFALLBACK 12: FreeCryptoAPI\n──────────────────────────\nURL: https://api.freecryptoapi.com\nFree: Beginner-friendly\nCoverage: 3,000+ coins\n\nFALLBACK 13: DIA Data\n─────────────────────\nURL: https://api.diadata.org/v1\nFree: Decentralized oracle\nTransparent pricing\nDocs: https://docs.diadata.org\n\nFALLBACK 14: Alternative.me\n───────────────────────────\nURL: https://api.alternative.me/v2\nFree: Price + Fear & Greed\nDocs: In API responses\n\nFALLBACK 15: CoinStats API\n──────────────────────────\nURL: https://api.coinstats.app/public/v1\nFree tier available\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 📰 NEWS & SOCIAL APIs - APIهای اخبار و شبکههای اجتماعی\n═══════════════════════════════════════════════════════════════════════════════════════\n\nCATEGORY 1: CRYPTO NEWS (10+ endpoints)\n────────────────────────────────────────\n\nPRIMARY: CryptoPanic (FREE)\n───────────────────────────\nURL: https://cryptopanic.com/api/v1\nFree: بله\nDocs: https://cryptopanic.com/developers/api/\n\nEndpoints:\n• Posts: /posts/?auth_token={TOKEN}&public=true\n• Currencies: /posts/?currencies=BTC,ETH\n• Filter: /posts/?filter=rising\n\nExample:\nfetch('https://cryptopanic.com/api/v1/posts/?public=true')\n .then(r => r.json())\n .then(data => console.log(data.results));\n\nFALLBACK 1: NewsAPI.org\n───────────────────────\nURL: https://newsapi.org/v2\nKey: pub_346789abc123def456789ghi012345jkl\nFree: 100 req/day\nDocs: https://newsapi.org/docs\n\nFALLBACK 2: CryptoControl\n─────────────────────────\nURL: https://cryptocontrol.io/api/v1/public\nFree tier available\nDocs: https://cryptocontrol.io/api\n\nFALLBACK 3: CoinDesk News\n─────────────────────────\nURL: https://www.coindesk.com/arc/outboundfeeds/rss/\nFree RSS feed\n\nFALLBACK 4: CoinTelegraph API\n─────────────────────────────\nURL: https://cointelegraph.com/api/v1\nFree: RSS and JSON feeds\n\nFALLBACK 5: CryptoSlate\n───────────────────────\nURL: https://cryptoslate.com/api\nFree: Limited\n\nFALLBACK 6: The Block API\n─────────────────────────\nURL: https://api.theblock.co/v1\nPremium service\n\nFALLBACK 7: Bitcoin Magazine RSS\n────────────────────────────────\nURL: https://bitcoinmagazine.com/.rss/full/\nFree RSS\n\nFALLBACK 8: Decrypt RSS\n───────────────────────\nURL: https://decrypt.co/feed\nFree RSS\n\nFALLBACK 9: Reddit Crypto\n─────────────────────────\nURL: https://www.reddit.com/r/CryptoCurrency/new.json\nFree: Public JSON\nLimit: 60 req/min\n\nExample:\nfetch('https://www.reddit.com/r/CryptoCurrency/hot.json?limit=25')\n .then(r => r.json())\n .then(data => console.log(data.data.children));\n\nFALLBACK 10: Twitter/X API (v2)\n───────────────────────────────\nURL: https://api.twitter.com/2\nRequires: OAuth 2.0\nFree tier: 1,500 tweets/month\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 😱 SENTIMENT & MOOD APIs - APIهای احساسات بازار\n═══════════════════════════════════════════════════════════════════════════════════════\n\nCATEGORY 1: FEAR & GREED INDEX (5+ endpoints)\n──────────────────────────────────────────────\n\nPRIMARY: Alternative.me (FREE)\n──────────────────────────────\nURL: https://api.alternative.me/fng/\nFree: بدون محدودیت\nDocs: https://alternative.me/crypto/fear-and-greed-index/\n\nEndpoints:\n• Current: /?limit=1\n• Historical: /?limit=30\n• Date Range: /?limit=10&date_format=world\n\nExample:\nfetch('https://api.alternative.me/fng/?limit=1')\n .then(r => r.json())\n .then(data => {\n const fng = data.data[0];\n console.log(`Fear & Greed: ${fng.value} - ${fng.value_classification}`);\n });\n// Output: \"Fear & Greed: 45 - Fear\"\n\nFALLBACK 1: LunarCrush\n──────────────────────\nURL: https://api.lunarcrush.com/v2\nFree tier: Limited\nDocs: https://lunarcrush.com/developers/api\n\nEndpoints:\n• Assets: ?data=assets&key={KEY}\n• Market: ?data=market&key={KEY}\n• Influencers: ?data=influencers&key={KEY}\n\nFALLBACK 2: Santiment (GraphQL)\n────────────────────────────────\nURL: https://api.santiment.net/graphql\nFree tier available\nDocs: https://api.santiment.net/graphiql\n\nGraphQL Example:\nquery {\n getMetric(metric: \"sentiment_balance_total\") {\n timeseriesData(\n slug: \"bitcoin\"\n from: \"2025-10-01T00:00:00Z\"\n to: \"2025-10-31T00:00:00Z\"\n interval: \"1d\"\n ) {\n datetime\n value\n }\n }\n}\n\nFALLBACK 3: TheTie.io\n─────────────────────\nURL: https://api.thetie.io\nPremium mainly\nDocs: https://docs.thetie.io\n\nFALLBACK 4: CryptoQuant\n───────────────────────\nURL: https://api.cryptoquant.com/v1\nFree tier: Limited\nDocs: https://docs.cryptoquant.com\n\nFALLBACK 5: Glassnode Social\n────────────────────────────\nURL: https://api.glassnode.com/v1/metrics/social\nFree tier: Limited\nDocs: https://docs.glassnode.com\n\nFALLBACK 6: Augmento (Social)\n──────────────────────────────\nURL: https://api.augmento.ai/v1\nAI-powered sentiment\nFree trial available\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 🐋 WHALE TRACKING APIs - APIهای ردیابی نهنگها\n═══════════════════════════════════════════════════════════════════════════════════════\n\nCATEGORY 1: WHALE TRANSACTIONS (8+ endpoints)\n──────────────────────────────────────────────\n\nPRIMARY: Whale Alert\n────────────────────\nURL: https://api.whale-alert.io/v1\nFree: Limited (7-day trial)\nPaid: From $20/month\nDocs: https://docs.whale-alert.io\n\nEndpoints:\n• Transactions: /transactions?api_key={KEY}&min_value=1000000&start={timestamp}&end={timestamp}\n• Status: /status?api_key={KEY}\n\nExample:\nconst start = Math.floor(Date.now()/1000) - 3600; // 1 hour ago\nconst end = Math.floor(Date.now()/1000);\nfetch(`https://api.whale-alert.io/v1/transactions?api_key=YOUR_KEY&min_value=1000000&start=${start}&end=${end}`)\n .then(r => r.json())\n .then(data => {\n data.transactions.forEach(tx => {\n console.log(`${tx.amount} ${tx.symbol} from ${tx.from.owner} to ${tx.to.owner}`);\n });\n });\n\nFALLBACK 1: ClankApp (FREE)\n───────────────────────────\nURL: https://clankapp.com/api\nFree: بله\nTelegram: @clankapp\nTwitter: @ClankApp\nDocs: https://clankapp.com/api/\n\nFeatures:\n• 24 blockchains\n• Real-time whale alerts\n• Email & push notifications\n• No API key needed\n\nExample:\nfetch('https://clankapp.com/api/whales/recent')\n .then(r => r.json())\n .then(data => console.log(data));\n\nFALLBACK 2: BitQuery Whale Tracking\n────────────────────────────────────\nURL: https://graphql.bitquery.io\nFree: 10K queries/month\nDocs: https://docs.bitquery.io\n\nGraphQL Example (Large ETH Transfers):\n{\n ethereum(network: ethereum) {\n transfers(\n amount: {gt: 1000}\n currency: {is: \"ETH\"}\n date: {since: \"2025-10-25\"}\n ) {\n block { timestamp { time } }\n sender { address }\n receiver { address }\n amount\n transaction { hash }\n }\n }\n}\n\nFALLBACK 3: Arkham Intelligence\n────────────────────────────────\nURL: https://api.arkham.com\nPaid service mainly\nDocs: https://docs.arkham.com\n\nFALLBACK 4: Nansen\n──────────────────\nURL: https://api.nansen.ai/v1\nPremium: Expensive but powerful\nDocs: https://docs.nansen.ai\n\nFeatures:\n• Smart Money tracking\n• Wallet labeling\n• Multi-chain support\n\nFALLBACK 5: DexCheck Whale Tracker\n───────────────────────────────────\nFree wallet tracking feature\n22 chains supported\nTelegram bot integration\n\nFALLBACK 6: DeBank\n──────────────────\nURL: https://api.debank.com\nFree: Portfolio tracking\nWeb3 social features\n\nFALLBACK 7: Zerion API\n──────────────────────\nURL: https://api.zerion.io\nSimilar to DeBank\nDeFi portfolio tracker\n\nFALLBACK 8: Whalemap\n────────────────────\nURL: https://whalemap.io\nBitcoin & ERC-20 focus\nCharts and analytics\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 🔍 ON-CHAIN ANALYTICS APIs - APIهای تحلیل زنجیره\n═══════════════════════════════════════════════════════════════════════════════════════\n\nCATEGORY 1: BLOCKCHAIN DATA (10+ endpoints)\n────────────────────────────────────────────\n\nPRIMARY: The Graph (Subgraphs)\n──────────────────────────────\nURL: https://api.thegraph.com/subgraphs/name/{org}/{subgraph}\nFree: Public subgraphs\nDocs: https://thegraph.com/docs/\n\nPopular Subgraphs:\n• Uniswap V3: /uniswap/uniswap-v3\n• Aave V2: /aave/protocol-v2\n• Compound: /graphprotocol/compound-v2\n\nExample (Uniswap V3):\nfetch('https://api.thegraph.com/subgraphs/name/uniswap/uniswap-v3', {\n method: 'POST',\n headers: {'Content-Type': 'application/json'},\n body: JSON.stringify({\n query: `{\n pools(first: 5, orderBy: volumeUSD, orderDirection: desc) {\n id\n token0 { symbol }\n token1 { symbol }\n volumeUSD\n }\n }`\n })\n})\n\nFALLBACK 1: Glassnode\n─────────────────────\nURL: https://api.glassnode.com/v1\nFree tier: Limited metrics\nDocs: https://docs.glassnode.com\n\nEndpoints:\n• SOPR: /metrics/indicators/sopr?a=BTC&api_key={KEY}\n• HODL Waves: /metrics/supply/hodl_waves?a=BTC&api_key={KEY}\n\nFALLBACK 2: IntoTheBlock\n────────────────────────\nURL: https://api.intotheblock.com/v1\nFree tier available\nDocs: https://developers.intotheblock.com\n\nFALLBACK 3: Dune Analytics\n──────────────────────────\nURL: https://api.dune.com/api/v1\nFree: Query results\nDocs: https://docs.dune.com/api-reference/\n\nFALLBACK 4: Covalent\n────────────────────\nURL: https://api.covalenthq.com/v1\nFree tier: 100K credits\nMulti-chain support\nDocs: https://www.covalenthq.com/docs/api/\n\nExample (Ethereum balances):\nfetch('https://api.covalenthq.com/v1/1/address/0x.../balances_v2/?key=YOUR_KEY')\n\nFALLBACK 5: Moralis\n───────────────────\nURL: https://deep-index.moralis.io/api/v2\nFree: 100K compute units/month\nDocs: https://docs.moralis.io\n\nFALLBACK 6: Alchemy NFT API\n───────────────────────────\nIncluded with Alchemy account\nNFT metadata & transfers\n\nFALLBACK 7: QuickNode Functions\n────────────────────────────────\nCustom on-chain queries\nToken balances, NFTs\n\nFALLBACK 8: Transpose\n─────────────────────\nURL: https://api.transpose.io\nFree tier available\nSQL-like queries\n\nFALLBACK 9: Footprint Analytics\n────────────────────────────────\nURL: https://api.footprint.network\nFree: Community tier\nNo-code analytics\n\nFALLBACK 10: Nansen Query\n─────────────────────────\nPremium institutional tool\nAdvanced on-chain intelligence\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 🔧 COMPLETE JAVASCRIPT IMPLEMENTATION\n پیادهسازی کامل جاوااسکریپت\n═══════════════════════════════════════════════════════════════════════════════════════\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// CONFIG.JS - تنظیمات مرکزی API\n// ═══════════════════════════════════════════════════════════════════════════════\n\nconst API_CONFIG = {\n // CORS Proxies (پروکسیهای CORS)\n corsProxies: [\n 'https://api.allorigins.win/get?url=',\n 'https://proxy.cors.sh/',\n 'https://proxy.corsfix.com/?url=',\n 'https://api.codetabs.com/v1/proxy?quest=',\n 'https://thingproxy.freeboard.io/fetch/'\n ],\n \n // Block Explorers (کاوشگرهای بلاکچین)\n explorers: {\n ethereum: {\n primary: {\n name: 'etherscan',\n baseUrl: 'https://api.etherscan.io/api',\n key: 'SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2',\n rateLimit: 5 // calls per second\n },\n fallbacks: [\n { name: 'etherscan2', baseUrl: 'https://api.etherscan.io/api', key: 'T6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45' },\n { name: 'blockchair', baseUrl: 'https://api.blockchair.com/ethereum', key: '' },\n { name: 'blockscout', baseUrl: 'https://eth.blockscout.com/api', key: '' },\n { name: 'ethplorer', baseUrl: 'https://api.ethplorer.io', key: 'freekey' }\n ]\n },\n bsc: {\n primary: {\n name: 'bscscan',\n baseUrl: 'https://api.bscscan.com/api',\n key: 'K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT',\n rateLimit: 5\n },\n fallbacks: [\n { name: 'blockchair', baseUrl: 'https://api.blockchair.com/binance-smart-chain', key: '' },\n { name: 'bitquery', baseUrl: 'https://graphql.bitquery.io', key: '', method: 'graphql' }\n ]\n },\n tron: {\n primary: {\n name: 'tronscan',\n baseUrl: 'https://apilist.tronscanapi.com/api',\n key: '7ae72726-bffe-4e74-9c33-97b761eeea21',\n rateLimit: 10\n },\n fallbacks: [\n { name: 'trongrid', baseUrl: 'https://api.trongrid.io', key: '' },\n { name: 'tronstack', baseUrl: 'https://api.tronstack.io', key: '' },\n { name: 'blockchair', baseUrl: 'https://api.blockchair.com/tron', key: '' }\n ]\n }\n },\n \n // Market Data (دادههای بازار)\n marketData: {\n primary: {\n name: 'coingecko',\n baseUrl: 'https://api.coingecko.com/api/v3',\n key: '', // بدون کلید\n needsProxy: false,\n rateLimit: 50 // calls per minute\n },\n fallbacks: [\n { \n name: 'coinmarketcap', \n baseUrl: 'https://pro-api.coinmarketcap.com/v1',\n key: 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c',\n headerKey: 'X-CMC_PRO_API_KEY',\n needsProxy: true\n },\n { \n name: 'coinmarketcap2', \n baseUrl: 'https://pro-api.coinmarketcap.com/v1',\n key: '04cf4b5b-9868-465c-8ba0-9f2e78c92eb1',\n headerKey: 'X-CMC_PRO_API_KEY',\n needsProxy: true\n },\n { name: 'coincap', baseUrl: 'https://api.coincap.io/v2', key: '' },\n { name: 'coinpaprika', baseUrl: 'https://api.coinpaprika.com/v1', key: '' },\n { name: 'binance', baseUrl: 'https://api.binance.com/api/v3', key: '' },\n { name: 'coinlore', baseUrl: 'https://api.coinlore.net/api', key: '' }\n ]\n },\n \n // RPC Nodes (نودهای RPC)\n rpcNodes: {\n ethereum: [\n 'https://eth.llamarpc.com',\n 'https://ethereum.publicnode.com',\n 'https://cloudflare-eth.com',\n 'https://rpc.ankr.com/eth',\n 'https://eth.drpc.org'\n ],\n bsc: [\n 'https://bsc-dataseed.binance.org',\n 'https://bsc-dataseed1.defibit.io',\n 'https://rpc.ankr.com/bsc',\n 'https://bsc-rpc.publicnode.com'\n ],\n polygon: [\n 'https://polygon-rpc.com',\n 'https://rpc.ankr.com/polygon',\n 'https://polygon-bor-rpc.publicnode.com'\n ]\n },\n \n // News Sources (منابع خبری)\n news: {\n primary: {\n name: 'cryptopanic',\n baseUrl: 'https://cryptopanic.com/api/v1',\n key: '',\n needsProxy: false\n },\n fallbacks: [\n { name: 'reddit', baseUrl: 'https://www.reddit.com/r/CryptoCurrency', key: '' }\n ]\n },\n \n // Sentiment (احساسات)\n sentiment: {\n primary: {\n name: 'alternative.me',\n baseUrl: 'https://api.alternative.me/fng',\n key: '',\n needsProxy: false\n }\n },\n \n // Whale Tracking (ردیابی نهنگ)\n whaleTracking: {\n primary: {\n name: 'clankapp',\n baseUrl: 'https://clankapp.com/api',\n key: '',\n needsProxy: false\n }\n }\n};\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// API-CLIENT.JS - کلاینت API با مدیریت خطا و fallback\n// ═══════════════════════════════════════════════════════════════════════════════\n\nclass CryptoAPIClient {\n constructor(config) {\n this.config = config;\n this.currentProxyIndex = 0;\n this.requestCache = new Map();\n this.cacheTimeout = 60000; // 1 minute\n }\n \n // استفاده از CORS Proxy\n async fetchWithProxy(url, options = {}) {\n const proxies = this.config.corsProxies;\n \n for (let i = 0; i < proxies.length; i++) {\n const proxyUrl = proxies[this.currentProxyIndex] + encodeURIComponent(url);\n \n try {\n console.log(`🔄 Trying proxy ${this.currentProxyIndex + 1}/${proxies.length}`);\n \n const response = await fetch(proxyUrl, {\n ...options,\n headers: {\n ...options.headers,\n 'Origin': window.location.origin,\n 'x-requested-with': 'XMLHttpRequest'\n }\n });\n \n if (response.ok) {\n const data = await response.json();\n // Handle allOrigins response format\n return data.contents ? JSON.parse(data.contents) : data;\n }\n } catch (error) {\n console.warn(`❌ Proxy ${this.currentProxyIndex + 1} failed:`, error.message);\n }\n \n // Switch to next proxy\n this.currentProxyIndex = (this.currentProxyIndex + 1) % proxies.length;\n }\n \n throw new Error('All CORS proxies failed');\n }\n \n // بدون پروکسی\n async fetchDirect(url, options = {}) {\n try {\n const response = await fetch(url, options);\n if (!response.ok) throw new Error(`HTTP ${response.status}`);\n return await response.json();\n } catch (error) {\n throw new Error(`Direct fetch failed: ${error.message}`);\n }\n }\n \n // با cache و fallback\n async fetchWithFallback(primaryConfig, fallbacks, endpoint, params = {}) {\n const cacheKey = `${primaryConfig.name}-${endpoint}-${JSON.stringify(params)}`;\n \n // Check cache\n if (this.requestCache.has(cacheKey)) {\n const cached = this.requestCache.get(cacheKey);\n if (Date.now() - cached.timestamp < this.cacheTimeout) {\n console.log('📦 Using cached data');\n return cached.data;\n }\n }\n \n // Try primary\n try {\n const data = await this.makeRequest(primaryConfig, endpoint, params);\n this.requestCache.set(cacheKey, { data, timestamp: Date.now() });\n return data;\n } catch (error) {\n console.warn('⚠️ Primary failed, trying fallbacks...', error.message);\n }\n \n // Try fallbacks\n for (const fallback of fallbacks) {\n try {\n console.log(`🔄 Trying fallback: ${fallback.name}`);\n const data = await this.makeRequest(fallback, endpoint, params);\n this.requestCache.set(cacheKey, { data, timestamp: Date.now() });\n return data;\n } catch (error) {\n console.warn(`❌ Fallback ${fallback.name} failed:`, error.message);\n }\n }\n \n throw new Error('All endpoints failed');\n }\n \n // ساخت درخواست\n async makeRequest(apiConfig, endpoint, params = {}) {\n let url = `${apiConfig.baseUrl}${endpoint}`;\n \n // Add query params\n const queryParams = new URLSearchParams();\n if (apiConfig.key) {\n queryParams.append('apikey', apiConfig.key);\n }\n Object.entries(params).forEach(([key, value]) => {\n queryParams.append(key, value);\n });\n \n if (queryParams.toString()) {\n url += '?' + queryParams.toString();\n }\n \n const options = {};\n \n // Add headers if needed\n if (apiConfig.headerKey && apiConfig.key) {\n options.headers = {\n [apiConfig.headerKey]: apiConfig.key\n };\n }\n \n // Use proxy if needed\n if (apiConfig.needsProxy) {\n return await this.fetchWithProxy(url, options);\n } else {\n return await this.fetchDirect(url, options);\n }\n }\n \n // ═══════════════ SPECIFIC API METHODS ═══════════════\n \n // Get ETH Balance (با fallback)\n async getEthBalance(address) {\n const { ethereum } = this.config.explorers;\n return await this.fetchWithFallback(\n ethereum.primary,\n ethereum.fallbacks,\n '',\n {\n module: 'account',\n action: 'balance',\n address: address,\n tag: 'latest'\n }\n );\n }\n \n // Get BTC Price (multi-source)\n async getBitcoinPrice() {\n const { marketData } = this.config;\n \n try {\n // Try CoinGecko first (no key needed, no CORS)\n const data = await this.fetchDirect(\n `${marketData.primary.baseUrl}/simple/price?ids=bitcoin&vs_currencies=usd,eur`\n );\n return {\n source: 'CoinGecko',\n usd: data.bitcoin.usd,\n eur: data.bitcoin.eur\n };\n } catch (error) {\n // Fallback to Binance\n try {\n const data = await this.fetchDirect(\n 'https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT'\n );\n return {\n source: 'Binance',\n usd: parseFloat(data.price),\n eur: null\n };\n } catch (err) {\n throw new Error('All price sources failed');\n }\n }\n }\n \n // Get Fear & Greed Index\n async getFearGreed() {\n const url = `${this.config.sentiment.primary.baseUrl}/?limit=1`;\n const data = await this.fetchDirect(url);\n return {\n value: parseInt(data.data[0].value),\n classification: data.data[0].value_classification,\n timestamp: new Date(parseInt(data.data[0].timestamp) * 1000)\n };\n }\n \n // Get Trending Coins\n async getTrendingCoins() {\n const url = `${this.config.marketData.primary.baseUrl}/search/trending`;\n const data = await this.fetchDirect(url);\n return data.coins.map(item => ({\n id: item.item.id,\n name: item.item.name,\n symbol: item.item.symbol,\n rank: item.item.market_cap_rank,\n thumb: item.item.thumb\n }));\n }\n \n // Get Crypto News\n async getCryptoNews(limit = 10) {\n const url = `${this.config.news.primary.baseUrl}/posts/?public=true`;\n const data = await this.fetchDirect(url);\n return data.results.slice(0, limit).map(post => ({\n title: post.title,\n url: post.url,\n source: post.source.title,\n published: new Date(post.published_at)\n }));\n }\n \n // Get Recent Whale Transactions\n async getWhaleTransactions() {\n try {\n const url = `${this.config.whaleTracking.primary.baseUrl}/whales/recent`;\n return await this.fetchDirect(url);\n } catch (error) {\n console.warn('Whale API not available');\n return [];\n }\n }\n \n // Multi-source price aggregator\n async getAggregatedPrice(symbol) {\n const sources = [\n {\n name: 'CoinGecko',\n fetch: async () => {\n const data = await this.fetchDirect(\n `${this.config.marketData.primary.baseUrl}/simple/price?ids=${symbol}&vs_currencies=usd`\n );\n return data[symbol]?.usd;\n }\n },\n {\n name: 'Binance',\n fetch: async () => {\n const data = await this.fetchDirect(\n `https://api.binance.com/api/v3/ticker/price?symbol=${symbol.toUpperCase()}USDT`\n );\n return parseFloat(data.price);\n }\n },\n {\n name: 'CoinCap',\n fetch: async () => {\n const data = await this.fetchDirect(\n `https://api.coincap.io/v2/assets/${symbol}`\n );\n return parseFloat(data.data.priceUsd);\n }\n }\n ];\n \n const prices = await Promise.allSettled(\n sources.map(async source => ({\n source: source.name,\n price: await source.fetch()\n }))\n );\n \n const successful = prices\n .filter(p => p.status === 'fulfilled')\n .map(p => p.value);\n \n if (successful.length === 0) {\n throw new Error('All price sources failed');\n }\n \n const avgPrice = successful.reduce((sum, p) => sum + p.price, 0) / successful.length;\n \n return {\n symbol,\n sources: successful,\n average: avgPrice,\n spread: Math.max(...successful.map(p => p.price)) - Math.min(...successful.map(p => p.price))\n };\n }\n}\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// USAGE EXAMPLES - مثالهای استفاده\n// ═══════════════════════════════════════════════════════════════════════════════\n\n// Initialize\nconst api = new CryptoAPIClient(API_CONFIG);\n\n// Example 1: Get Ethereum Balance\nasync function example1() {\n try {\n const address = '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb';\n const balance = await api.getEthBalance(address);\n console.log('ETH Balance:', parseInt(balance.result) / 1e18);\n } catch (error) {\n console.error('Error:', error.message);\n }\n}\n\n// Example 2: Get Bitcoin Price from Multiple Sources\nasync function example2() {\n try {\n const price = await api.getBitcoinPrice();\n console.log(`BTC Price (${price.source}): $${price.usd}`);\n } catch (error) {\n console.error('Error:', error.message);\n }\n}\n\n// Example 3: Get Fear & Greed Index\nasync function example3() {\n try {\n const fng = await api.getFearGreed();\n console.log(`Fear & Greed: ${fng.value} (${fng.classification})`);\n } catch (error) {\n console.error('Error:', error.message);\n }\n}\n\n// Example 4: Get Trending Coins\nasync function example4() {\n try {\n const trending = await api.getTrendingCoins();\n console.log('Trending Coins:');\n trending.forEach((coin, i) => {\n console.log(`${i + 1}. ${coin.name} (${coin.symbol})`);\n });\n } catch (error) {\n console.error('Error:', error.message);\n }\n}\n\n// Example 5: Get Latest News\nasync function example5() {\n try {\n const news = await api.getCryptoNews(5);\n console.log('Latest News:');\n news.forEach((article, i) => {\n console.log(`${i + 1}. ${article.title} - ${article.source}`);\n });\n } catch (error) {\n console.error('Error:', error.message);\n }\n}\n\n// Example 6: Aggregate Price from Multiple Sources\nasync function example6() {\n try {\n const priceData = await api.getAggregatedPrice('bitcoin');\n console.log('Price Sources:');\n priceData.sources.forEach(s => {\n console.log(`- ${s.source}: $${s.price.toFixed(2)}`);\n });\n console.log(`Average: $${priceData.average.toFixed(2)}`);\n console.log(`Spread: $${priceData.spread.toFixed(2)}`);\n } catch (error) {\n console.error('Error:', error.message);\n }\n}\n\n// Example 7: Dashboard - All Data\nasync function dashboardExample() {\n console.log('🚀 Loading Crypto Dashboard...\\n');\n \n try {\n // Price\n const btcPrice = await api.getBitcoinPrice();\n console.log(`💰 BTC: $${btcPrice.usd.toLocaleString()}`);\n \n // Fear & Greed\n const fng = await api.getFearGreed();\n console.log(`😱 Fear & Greed: ${fng.value} (${fng.classification})`);\n \n // Trending\n const trending = await api.getTrendingCoins();\n console.log(`\\n🔥 Trending:`);\n trending.slice(0, 3).forEach((coin, i) => {\n console.log(` ${i + 1}. ${coin.name}`);\n });\n \n // News\n const news = await api.getCryptoNews(3);\n console.log(`\\n📰 Latest News:`);\n news.forEach((article, i) => {\n console.log(` ${i + 1}. ${article.title.substring(0, 50)}...`);\n });\n \n } catch (error) {\n console.error('Dashboard Error:', error.message);\n }\n}\n\n// Run examples\nconsole.log('═══════════════════════════════════════');\nconsole.log(' CRYPTO API CLIENT - TEST SUITE');\nconsole.log('═══════════════════════════════════════\\n');\n\n// Uncomment to run specific examples:\n// example1();\n// example2();\n// example3();\n// example4();\n// example5();\n// example6();\ndashboardExample();\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 📝 QUICK REFERENCE - مرجع سریع\n═══════════════════════════════════════════════════════════════════════════════════════\n\nBEST FREE APIs (بهترین APIهای رایگان):\n─────────────────────────────────────────\n\n✅ PRICES & MARKET DATA:\n 1. CoinGecko (بدون کلید، بدون CORS)\n 2. Binance Public API (بدون کلید)\n 3. CoinCap (بدون کلید)\n 4. CoinPaprika (بدون کلید)\n\n✅ BLOCK EXPLORERS:\n 1. Blockchair (1,440 req/day)\n 2. BlockScout (بدون محدودیت)\n 3. Public RPC nodes (various)\n\n✅ NEWS:\n 1. CryptoPanic (بدون کلید)\n 2. Reddit JSON API (60 req/min)\n\n✅ SENTIMENT:\n 1. Alternative.me F&G (بدون محدودیت)\n\n✅ WHALE TRACKING:\n 1. ClankApp (بدون کلید)\n 2. BitQuery GraphQL (10K/month)\n\n✅ RPC NODES:\n 1. PublicNode (همه شبکهها)\n 2. Ankr (عمومی)\n 3. LlamaNodes (بدون ثبتنام)\n\n\nRATE LIMIT STRATEGIES (استراتژیهای محدودیت):\n───────────────────────────────────────────────\n\n1. کش کردن (Caching):\n - ذخیره نتایج برای 1-5 دقیقه\n - استفاده از localStorage برای کش مرورگر\n\n2. چرخش کلید (Key Rotation):\n - استفاده از چندین کلید API\n - تعویض خودکار در صورت محدودیت\n\n3. Fallback Chain:\n - Primary → Fallback1 → Fallback2\n - تا 5-10 جایگزین برای هر سرویس\n\n4. Request Queuing:\n - صف بندی درخواستها\n - تاخیر بین درخواستها\n\n5. Multi-Source Aggregation:\n - دریافت از چند منبع همزمان\n - میانگین گیری نتایج\n\n\nERROR HANDLING (مدیریت خطا):\n──────────────────────────────\n\ntry {\n const data = await api.fetchWithFallback(primary, fallbacks, endpoint, params);\n} catch (error) {\n if (error.message.includes('rate limit')) {\n // Switch to fallback\n } else if (error.message.includes('CORS')) {\n // Use CORS proxy\n } else {\n // Show error to user\n }\n}\n\n\nDEPLOYMENT TIPS (نکات استقرار):\n─────────────────────────────────\n\n1. Backend Proxy (توصیه میشود):\n - Node.js/Express proxy server\n - Cloudflare Worker\n - Vercel Serverless Function\n\n2. Environment Variables:\n - ذخیره کلیدها در .env\n - عدم نمایش در کد فرانتاند\n\n3. Rate Limiting:\n - محدودسازی درخواست کاربر\n - استفاده از Redis برای کنترل\n\n4. Monitoring:\n - لاگ گرفتن از خطاها\n - ردیابی استفاده از API\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n 🔗 USEFUL LINKS - لینکهای مفید\n═══════════════════════════════════════════════════════════════════════════════════════\n\nDOCUMENTATION:\n• CoinGecko API: https://www.coingecko.com/api/documentation\n• Etherscan API: https://docs.etherscan.io\n• BscScan API: https://docs.bscscan.com\n• TronGrid: https://developers.tron.network\n• Alchemy: https://docs.alchemy.com\n• Infura: https://docs.infura.io\n• The Graph: https://thegraph.com/docs\n• BitQuery: https://docs.bitquery.io\n\nCORS PROXY ALTERNATIVES:\n• CORS Anywhere: https://github.com/Rob--W/cors-anywhere\n• AllOrigins: https://github.com/gnuns/allOrigins\n• CORS.SH: https://cors.sh\n• Corsfix: https://corsfix.com\n\nRPC LISTS:\n• ChainList: https://chainlist.org\n• Awesome RPC: https://github.com/arddluma/awesome-list-rpc-nodes-providers\n\nTOOLS:\n• Postman: https://www.postman.com\n• Insomnia: https://insomnia.rest\n• GraphiQL: https://graphiql-online.com\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n ⚠️ IMPORTANT NOTES - نکات مهم\n═══════════════════════════════════════════════════════════════════════════════════════\n\n1. ⚠️ NEVER expose API keys in frontend code\n - همیشه از backend proxy استفاده کنید\n - کلیدها را در environment variables ذخیره کنید\n\n2. 🔄 Always implement fallbacks\n - حداقل 2-3 جایگزین برای هر سرویس\n - تست منظم fallbackها\n\n3. 💾 Cache responses when possible\n - صرفهجویی در استفاده از API\n - سرعت بیشتر برای کاربر\n\n4. 📊 Monitor API usage\n - ردیابی تعداد درخواستها\n - هشدار قبل از رسیدن به محدودیت\n\n5. 🔐 Secure your endpoints\n - محدودسازی domain\n - استفاده از CORS headers\n - Rate limiting برای کاربران\n\n6. 🌐 Test with and without CORS proxies\n - برخی APIها CORS را پشتیبانی میکنند\n - استفاده از پروکسی فقط در صورت نیاز\n\n7. 📱 Mobile-friendly implementations\n - بهینهسازی برای شبکههای ضعیف\n - کاهش اندازه درخواستها\n\n\n═══════════════════════════════════════════════════════════════════════════════════════\n END OF CONFIGURATION FILE\n پایان فایل تنظیمات\n═══════════════════════════════════════════════════════════════════════════════════════\n\nLast Updated: October 31, 2025\nVersion: 2.0\nAuthor: AI Assistant\nLicense: Free to use\n\nFor updates and more resources, check:\n- GitHub: Search for \"awesome-crypto-apis\"\n- Reddit: r/CryptoCurrency, r/ethdev\n- Discord: Web3 developer communities"
},
{
"filename": "api - Copy.txt",
"content": "\n tronscan\n7ae72726-bffe-4e74-9c33-97b761eeea21\t\n\nBscscan\t\nK62RKHGXTDCG53RU4MCG6XABIMJKTN19IT\n\neherscann_2\t\nT6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45\n\neherscann\t\nSZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2\n\ncoinmarketcap\n04cf4b5b-9868-465c-8ba0-9f2e78c92eb1\n\n\nCOINMARKETCAP_KEY:\nb54bcf4d-1bca-4e8e-9a24-22ff2c3d462c\n\nNEWSAPI_KEY: \npub_346789abc123def456789ghi012345jkl\n\nCRYPTOCOMPARE_KEY:\ne79c8e6d4c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f\n\n\nدر ادامه ۳۸ سرویس (primary + fallbacks) که قبلاً در حافظه داشتیم را دستهبندی و لیست کردهام، و روشهای ردیابی فعالیت نهنگها را هم به بخش مربوط اضافه کردم. این لیست در حافظه ذخیره شد.\n\n۱. Block Explorer APIs (۱۱ endpoint)\nTronScan (primary)\n\nTronGrid (fallback)\n\nBlockchair (TRON) (fallback)\n\nBscScan (primary)\n\nAnkrScan (BSC) (fallback)\n\nBinTools (BSC) (fallback)\n\nEtherscan (primary)\n\nEtherscan (backup key) (fallback)\n\nInfura (ETH) (fallback)\n\nAlchemy (ETH) (fallback)\n\nCovalent (ETH) (fallback)\n\n۲. Market Data APIs (۹ endpoint)\nCoinMarketCap (primary key #1)\n\nCoinMarketCap (primary key #2)\n\nCoinGecko (no key)\n\nNomics\n\nMessari\n\nBraveNewCoin\n\nCryptoCompare (primary)\n\nKaiko (fallback)\n\nCoinAPI.io (fallback)\n\n۳. News APIs (۷ endpoint)\nNewsAPI.org\n\nCryptoPanic\n\nCryptoControl\n\nCoinDesk API\n\nCoinTelegraph API\n\nCryptoSlate API\n\nThe Block API\n\n۴. Sentiment & Mood APIs (۴ endpoint)\nAlternative.me (Fear & Greed)\n\nSantiment\n\nLunarCrush\n\nTheTie.io\n\n۵. On-Chain Analytics APIs (۴ endpoint)\nGlassnode\n\nIntoTheBlock\n\nNansen\n\nThe Graph (subgraphs)\n\n۶. Whale-Tracking APIs (۲ endpoint)\nWhaleAlert (primary)\n\nArkham Intelligence (fallback)\n\nروشهای ردیابی فعالیت نهنگها\nپویش تراکنشهای بزرگ\n\nبا WhaleAlert هر X ثانیه، endpoint /v1/transactions رو poll کن و فقط TX با مقدار دلخواه (مثلاً >۱M دلار) رو نمایش بده.\n\nوبهوک/نوتیفیکیشن\n\nاز قابلیت Webhook در WhaleAlert یا Arkham استفاده کن تا بهمحض رخداد تراکنش بزرگ، درخواست POST بیاد.\n\nفیلتر مستقیم روی WebSocket\n\nاگر Infura/Alchemy یا BscScan WebSocket دارن، به mempool گوش بده و TXهایی با حجم بالا رو فیلتر کن.\n\nداشبورد نهنگها از Nansen یا Dune\n\nاز Nansen Alerts یا کوئریهای Dune برای رصد کیفپولهای شناختهشده (smart money) و انتقالاتشان استفاده کن.\n\nنقشه حرارتی (Heatmap) تراکنشها\n\nدادههای WhaleAlert رو در یک نمودار خطی یا نقشه پخش جغرافیایی (اگر GPS دارن) نمایش بده.\n\n۷. Community Sentiment (۱ endpoint)\nReddit\n\n\n\nBlock Explorer APIs (۱۱ سرویس) \nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی\nTronScan\tGET https://api.tronscan.org/api/account?address={address}&apiKey={KEY}\tجزئیات حساب و موجودی Tron\tfetch(url)، پارس JSON، نمایش balance\nTronGrid\tGET https://api.trongrid.io/v1/accounts/{address}?apiKey={KEY}\tهمان عملکرد TronScan با endpoint متفاوت\tمشابه fetch با URL جدید\nBlockchair\tGET https://api.blockchair.com/tron/dashboards/address/{address}?key={KEY}\tداشبورد آدرس TRON\tfetch(url)، استفاده از data.address\nBscScan\tGET https://api.bscscan.com/api?module=account&action=balance&address={address}&apikey={KEY}\tموجودی حساب BSC\tfetch(url)، نمایش result\nAnkrScan\tGET https://api.ankr.com/scan/v1/bsc/address/{address}/balance?apiKey={KEY}\tموجودی از API آنکر\tfetch(url)، پارس JSON\nBinTools\tGET https://api.bintools.io/v1/bsc/account/balance?address={address}&apikey={KEY}\tجایگزین BscScan\tمشابه fetch\nEtherscan\tGET https://api.etherscan.io/api?module=account&action=balance&address={address}&apikey={KEY}\tموجودی حساب ETH\tfetch(url)، نمایش result\nEtherscan_2\tGET https://api.etherscan.io/api?module=account&action=balance&address={address}&apikey={SECOND_KEY}\tدومین کلید Etherscan\tهمانند بالا\nInfura\tJSON-RPC POST به https://mainnet.infura.io/v3/{PROJECT_ID} با بدنه { \"jsonrpc\":\"2.0\",\"method\":\"eth_getBalance\",\"params\":[\"{address}\",\"latest\"],\"id\":1 }\tاستعلام موجودی از طریق RPC\tfetch(url, {method:'POST', body:JSON.stringify(...)})\nAlchemy\tJSON-RPC POST به https://eth-mainnet.alchemyapi.io/v2/{KEY} همانند Infura\tاستعلام RPC با سرعت و WebSocket\tWebSocket: new WebSocket('wss://eth-mainnet.alchemyapi.io/v2/{KEY}')\nCovalent\tGET https://api.covalenthq.com/v1/1/address/{address}/balances_v2/?key={KEY}\tلیست داراییهای یک آدرس در شبکه Ethereum\tfetch(url), پارس data.items\n\n۲. Market Data APIs (۹ سرویس) \nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی\nCoinMarketCap\tGET https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest?symbol=BTC&convert=USD
Header: X-CMC_PRO_API_KEY: {KEY}\tقیمت لحظهای و تغییرات درصدی\tfetch(url,{headers:{'X-CMC_PRO_API_KEY':KEY}})\nCMC_Alt\tهمان endpoint بالا با کلید دوم\tکلید جایگزین CMC\tمانند بالا\nCoinGecko\tGET https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd\tبدون نیاز به کلید، قیمت ساده\tfetch(url)\nNomics\tGET https://api.nomics.com/v1/currencies/ticker?key={KEY}&ids=BTC,ETH&convert=USD\tقیمت و حجم معاملات\tfetch(url)\nMessari\tGET https://data.messari.io/api/v1/assets/bitcoin/metrics\tمتریکهای پیشرفته (TVL، ROI و…)\tfetch(url)\nBraveNewCoin\tGET https://bravenewcoin.p.rapidapi.com/ohlcv/BTC/latest
Headers: x-rapidapi-key: {KEY}\tقیمت OHLCV لحظهای\tfetch(url,{headers:{…}})\nCryptoCompare\tGET https://min-api.cryptocompare.com/data/pricemulti?fsyms=BTC,ETH&tsyms=USD&api_key={KEY}\tقیمت چندگانه کریپто\tfetch(url)\nKaiko\tGET https://us.market-api.kaiko.io/v2/data/trades.v1/exchanges/Coinbase/spot/trades?base_token=BTC"e_token=USD&page_limit=10&api_key={KEY}\tدیتای تریدهای زنده\tfetch(url)\nCoinAPI.io\tGET https://rest.coinapi.io/v1/exchangerate/BTC/USD?apikey={KEY}\tنرخ تبدیل بین رمزارز و فیات\tfetch(url)\n\n۳. News & Aggregators (۷ سرویس) \nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی\nNewsAPI.org\tGET https://newsapi.org/v2/everything?q=crypto&apiKey={KEY}\tاخبار گسترده\tfetch(url)\nCryptoPanic\tGET https://cryptopanic.com/api/v1/posts/?auth_token={KEY}\tجمعآوری اخبار از منابع متعدد\tfetch(url)\nCryptoControl\tGET https://cryptocontrol.io/api/v1/public/news/local?language=EN&apiKey={KEY}\tاخبار محلی و جهانی\tfetch(url)\nCoinDesk API\tGET https://api.coindesk.com/v2/prices/BTC/spot?api_key={KEY}\tقیمت لحظهای BTC\tfetch(url)\nCoinTelegraph\tGET https://api.cointelegraph.com/api/v1/articles?lang=en\tفید مقالات CoinTelegraph\tfetch(url)\nCryptoSlate\tGET https://api.cryptoslate.com/news\tاخبار و تحلیلهای CryptoSlate\tfetch(url)\nThe Block API\tGET https://api.theblock.co/v1/articles\tمقالات تخصصی بلاکچین\tfetch(url)\n\n۴. Sentiment & Mood (۴ سرویس) \nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی\nAlternative.me F&G\tGET https://api.alternative.me/fng/?limit=1&format=json\tشاخص ترس/طمع بازار\tfetch(url)، مقدار data[0].value\nSantiment\tGraphQL POST به https://api.santiment.net/graphql با { query: \"...sentiment...\" }\tاحساسات اجتماعی رمزارزها\tfetch(url,{method:'POST',body:!...})\nLunarCrush\tGET https://api.lunarcrush.com/v2?data=assets&key={KEY}\tمعیارهای اجتماعی و تعاملات\tfetch(url)\nTheTie.io\tGET https://api.thetie.io/data/sentiment?symbol=BTC&apiKey={KEY}\tتحلیل احساسات بر اساس توییتها\tfetch(url)\n\n۵. On-Chain Analytics (۴ سرویس)\nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی\nGlassnode\tGET https://api.glassnode.com/v1/metrics/indicators/sopr_ratio?api_key={KEY}\tشاخصهای زنجیرهای (SOPR، HODL، …)\tfetch(url)\nIntoTheBlock\tGET https://api.intotheblock.com/v1/insights/bitcoin/holders_breakdown?key={KEY}\tتجزیه و تحلیل دارندگان\tfetch(url)\nNansen\tGET https://api.nansen.ai/v1/balances?chain=ethereum&address={address}&api_key={KEY}\tمانیتور کیفپولهای هوشمند (Smart Money)\tfetch(url)\nThe Graph\tGraphQL POST به https://api.thegraph.com/subgraphs/name/uniswap/uniswap-v3 با queryهای اختصاصی\tدادههای on-chain از subgraphها\tfetch(url,{method:'POST',body:!...})\n\n۶. Whale-Tracking (۲ سرویس)\nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی\nWhaleAlert\tGET https://api.whale-alert.io/v1/transactions?api_key={KEY}&min_value=1000000&start={ts}&end={ts}\tتراکنشهای بزرگ زنجیرهها\tfetch(url)، فیلتر data.transactions با value>…\nArkham\tGET https://api.arkham.com/v1/address/{address}/transfers?api_key={KEY}\tانتقالات کیفپولهای شناختهشده\tfetch(url)، مانیتور transfers\n\nردیابی نهنگها:\n\nPolling دورهای → setInterval(()=>fetch(url), interval)\n\nWebhook (WhaleAlert webhook config)\n\nWebSocket (Alchemy/Infura mempool feed)\n\n۷. Community Sentiment (۱ سرویس)\nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی\nReddit\tGET https://www.reddit.com/r/CryptoCurrency/new.json?limit=10\tپستهای جدید در رِدیت\tfetch(url), پارس data.data.children\n\nذخیره در حافظه انجام شد.\n\n\nSources\n\n\n\n\n\n\n\n\nAsk ChatGPT\nYou said:\nبرای سنتمنت منابع بیشتری پیدا کن منابع ارزشمندتری پیدا کن مارکت کپ مگه کلیدشو در اختیارت نذاشتم\n\n\nChatGPT said:\n\nThought for 4 seconds\nدر جدول زیر منابع جدید و با ارزشتر برای تحلیل احساسات (Sentiment) گردآوری شدهاند، همراه با API واقعی و نحوهٔ پیادهسازی. همچنین کلید CoinMarketCap که در اختیارت قرار دادی در اینجا هاردکد شده است.\n\nمنابع پیشرفتهتر برای Sentiment\nسرویس\tAPI واقعی\tشرح\tنحوهٔ پیادهسازی (مثال)\nSantiment\tPOST https://api.santiment.net/graphql
Body:\t\t\n\njson\nCopy\nEdit\n{ \"query\":\"{ projects(slug: \\\"bitcoin\\\") { sentimentMetrics { socialVolume, socialDominance } } }\" }\n``` | حجم و تسلط بحثهای اجتماعی روی پروژهها | \n```js\nfetch(url, {\n method:'POST',\n headers:{'Content-Type':'application/json','Authorization':KEY},\n body:JSON.stringify({query:…})\n})\n.then(r=>r.json())\n.then(data=>console.log(data));\n``` |\n| **LunarCrush** | `GET https://api.lunarcrush.com/v2?data=assets&key={KEY}&symbol=BTC` | معیارهای تعاملی شبکههای اجتماعی (engagement) | \n```js\nfetch(url)\n .then(r=>r.json())\n .then(d=>console.log(d.data[0]));\n``` |\n| **TheTie.io** | `GET https://api.thetie.io/data/sentiment?symbol=BTC&interval=1h&apiKey={KEY}` | امتیاز احساسات بر اساس توییتها و اخبار | \n```js\nfetch(url)\n .then(r=>r.json())\n .then(d=>console.log(d.sentiment));\n``` |\n| **CryptoQuant** | `GET https://api.cryptoquant.com/v1/ohlcv/latest?symbol=BTC&token={KEY}` | شاخصهای درونزنجیرهای و احساسات نهنگها | \n```js\nfetch(url)\n .then(r=>r.json())\n .then(d=>console.log(d));\n``` |\n| **Glassnode Social**| `GET https://api.glassnode.com/v1/metrics/social/mention_count?api_key={KEY}&a=BTC` | تعداد ذکر شدن BTC در شبکههای اجتماعی | \n```js\nfetch(url)\n .then(r=>r.json())\n .then(d=>console.log(d));\n``` |\n| **CoinGecko Comm.** | `GET https://api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&market_data=false&community_data=true` | دادههای اجتماعی (Reddit, Twitter) | \n```js\nfetch(url)\n .then(r=>r.json())\n .then(d=>console.log(d.community_data));\n``` |\n| **Messari Social** | `GET https://data.messari.io/api/v1/assets/bitcoin/metrics/social` | متریکهای شبکههای اجتماعی (mentions, sentiment) | \n```js\nfetch(url)\n .then(r=>r.json())\n .then(d=>console.log(d.data));\n``` |\n| **Reddit API** | `GET https://www.reddit.com/r/CryptoCurrency/comments.json?limit=20` | کامنتها و ترندهای رِدیت | \n```js\nfetch(url)\n .then(r=>r.json())\n .then(d=>console.log(d.data.children));\n``` |\n\n> **نکته:** برای همهٔ این سرویسها باید `{KEY}` را با کد API خود پر کنید. \n> برای موارد GraphQL (Santiment, TheGraph) از `POST` و برای بقیه از `GET` استفاده میشود.\n\n---\n\n### بهروزرسانی CoinMarketCap در `config.js`\n\n```js\n// config.js\nexport const API_CONFIG = {\n // … بقیه سرویسها …\n\n // Market Data APIs\n coinmarketcap: {\n primary: {\n name: 'coinmarketcap',\n baseUrl: 'https://pro-api.coinmarketcap.com/v1',\n key: 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c' // COINMARKETCAP_KEY هاردکد شده\n },\n fallbacks: [\n {\n name: 'coinmarketcapAlt',\n baseUrl: 'https://pro-api.coinmarketcap.com/v1',\n key: '04cf4b5b-9868-465c-8ba0-9f2e78c92eb1' // کلید دوم\n },\n {\n name: 'coingecko',\n baseUrl: 'https://api.coingecko.com/api/v3',\n key: '' // بدون کلید\n }\n // … بقیه fallbacks …\n ]\n }\n\n // … سایر سرویسها …\n// config.js\nexport const API_CONFIG = {\n // 1. Block Explorer APIs (11 endpoints)\n tronscan: {\n primary: {\n name: 'tronscan',\n baseUrl: 'https://api.tronscan.org/api',\n key: '7ae72726-bffe-4e74-9c33-97b761eeea21'\n },\n fallbacks: [\n { name: 'tronGrid', baseUrl: 'https://api.trongrid.io', key: '' },\n { name: 'blockchair', baseUrl: 'https://api.blockchair.com/tron', key: '' }\n ]\n },\n bscscan: {\n primary: {\n name: 'bscscan',\n baseUrl: 'https://api.bscscan.com/api',\n key: 'K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT'\n },\n fallbacks: [\n { name: 'ankr', baseUrl: 'https://api.ankr.com/scan/bsc', key: '' },\n { name: 'binTools', baseUrl: 'https://api.bintools.io/bsc', key: '' }\n ]\n },\n etherscan: {\n primary: {\n name: 'etherscan',\n baseUrl: 'https://api.etherscan.io/api',\n key: 'SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2'\n },\n fallbacks: [\n { name: 'etherscan_2', baseUrl: 'https://api.etherscan.io/api', key: 'T6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45' },\n { name: 'infura', baseUrl: 'https://mainnet.infura.io/v3', key: '' },\n { name: 'alchemy', baseUrl: 'https://eth-mainnet.alchemyapi.io/v2', key: '' },\n { name: 'covalent', baseUrl: 'https://api.covalenthq.com/v1/1', key: '' }\n ]\n },\n\n // 2. Market Data APIs (9 endpoints)\n coinmarketcap: {\n primary: {\n name: 'coinmarketcap',\n baseUrl: 'https://pro-api.coinmarketcap.com/v1',\n key: 'b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c'\n },\n fallbacks: [\n { name: 'coinmarketcapAlt', baseUrl: 'https://pro-api.coinmarketcap.com/v1', key: '04cf4b5b-9868-465c-8ba0-9f2e78c92eb1' },\n { name: 'coingecko', baseUrl: 'https://api.coingecko.com/api/v3', key: '' },\n { name: 'nomics', baseUrl: 'https://api.nomics.com/v1', key: '' },\n { name: 'messari', baseUrl: 'https://data.messari.io/api/v1', key: '' },\n { name: 'braveNewCoin', baseUrl: 'https://bravenewcoin.p.rapidapi.com', key: '' }\n ]\n },\n cryptocompare: {\n primary: {\n name: 'cryptocompare',\n baseUrl: 'https://min-api.cryptocompare.com/data',\n key: 'e79c8e6d4c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f'\n },\n fallbacks: [\n { name: 'kaiko', baseUrl: 'https://us.market-api.kaiko.io/v2', key: '' },\n { name: 'coinapi', baseUrl: 'https://rest.coinapi.io/v1', key: '' }\n ]\n },\n\n // 3. News & Aggregators (7 endpoints)\n newsapi: {\n primary: {\n name: 'newsapi',\n baseUrl: 'https://newsapi.org/v2',\n key: 'pub_346789abc123def456789ghi012345jkl'\n },\n fallbacks: [\n { name: 'cryptoPanic', baseUrl: 'https://cryptopanic.com/api/v1', key: '' },\n { name: 'cryptoControl', baseUrl: 'https://cryptocontrol.io/api/v1/public', key: '' },\n { name: 'coinDesk', baseUrl: 'https://api.coindesk.com/v2', key: '' },\n { name: 'coinTelegraph', baseUrl: 'https://api.cointelegraph.com', key: '' },\n { name: 'cryptoSlate', baseUrl: 'https://api.cryptoslate.com', key: '' },\n { name: 'theBlock', baseUrl: 'https://api.theblock.co/v1', key: '' }\n ]\n },\n\n // 4. Sentiment & Mood (8 endpoints)\n // includes both basic and advanced sources\n sentiment: {\n primary: {\n name: 'alternativeMe',\n baseUrl: 'https://api.alternative.me/fng',\n key: ''\n },\n fallbacks: [\n { name: 'santiment', baseUrl: 'https://api.santiment.net/graphql', key: 'YOUR_SANTIMENT_KEY' },\n { name: 'lunarCrush', baseUrl: 'https://api.lunarcrush.com/v2', key: 'YOUR_LUNARCRUSH_KEY' },\n { name: 'theTie', baseUrl: 'https://api.thetie.io', key: 'YOUR_THETIE_KEY' },\n { name: 'cryptoQuant', baseUrl: 'https://api.cryptoquant.com/v1', key: 'YOUR_CRYPTOQUANT_KEY' },\n { name: 'glassnodeSocial',baseUrl: 'https://api.glassnode.com/v1', key: 'YOUR_GLASSNODE_KEY' },\n { name: 'coingeckoComm', baseUrl: 'https://api.coingecko.com/api/v3', key: '' },\n { name: 'messariSocial', baseUrl: 'https://data.messari.io/api/v1', key: '' },\n { name: 'reddit', baseUrl: 'https://www.reddit.com', key: '' }\n ]\n },\n\n // 5. On-Chain Analytics (4 endpoints)\n glassnode: { primary: { name: 'glassnode', baseUrl: 'https://api.glassnode.com/v1', key: '' } },\n intoTheBlock: { primary: { name: 'intoTheBlock', baseUrl: 'https://api.intotheblock.com/v1', key: '' } },\n nansen: { primary: { name: 'nansen', baseUrl: 'https://api.nansen.ai/v1', key: '' } },\n theGraph: { primary: { name: 'theGraph', baseUrl: 'https://api.thegraph.com/subgraphs/name', key: '' } },\n\n // 6. Whale-Tracking (2 endpoints)\n whaleAlert: {\n primary: { name: 'whaleAlert', baseUrl: 'https://api.whale-alert.io/v1', key: 'YOUR_WHALEALERT_KEY' },\n fallbacks: [\n { name: 'arkham', baseUrl: 'https://api.arkham.com', key: 'YOUR_ARKHAM_KEY' }\n ]\n }\n};\n\n\n\n\n\n\n\n\n\n"
}
],
"zip_listing": [
{
"name": "crypto_resources.ts",
"file_size": 39118,
"compress_size": 10933,
"is_dir": false
}
],
"zip_text_snippets": [
{
"filename": "crypto_resources.ts",
"text_preview": "// crypto_resources.ts — unified TS with 150+ Hugging Face sources (dynamic catalog) + Safe F&G aggregator\n// English-only comments. Keys intentionally embedded per user request.\n\nexport type Category =\n | 'market'\n | 'news'\n | 'sentiment'\n | 'onchain'\n | 'block_explorer'\n | 'whales'\n | 'generic'\n | 'hf';\n\nexport interface EndpointDef {\n path: string;\n method?: 'GET' | 'POST';\n sampleParams?: Record;\n authLocation?: 'header' | 'query';\n authName?: string;\n authValue?: string;\n contentType?: string;\n}\n\nexport interface CryptoResource {\n id: string;\n category: Category;\n name: string;\n baseUrl: string;\n free: boolean;\n rateLimit?: string;\n endpoints?: Record;\n}\n\nexport interface MarketQuote {\n id: string;\n symbol: string;\n name: string;\n price: number;\n change24h?: number;\n marketCap?: number;\n source: string;\n raw: any;\n}\n\nexport interface NewsItem {\n title: string;\n link: string;\n publishedAt?: string;\n source: string;\n}\n\nexport interface OHLCVRow {\n timestamp: number | string;\n open: number; high: number; low: number; close: number; volume: number;\n [k: string]: any;\n}\n\nexport interface FNGPoint {\n value: number; // 0..100\n classification: string;\n at?: string;\n source: string;\n raw?: any;\n}\n\nconst EMBEDDED_KEYS = {\n CMC: '04cf4b5b-9868-465c-8ba0-9f2e78c92eb1',\n ETHERSCAN: 'SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2',\n ETHERSCAN_BACKUP: 'T6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45',\n BSCSCAN: 'K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT',\n CRYPTOCOMPARE: 'e79c8e6d4c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f',\n\n // Optional free keys provided by user (kept in-code per request)\n MESSARI: '',\n SANTIMENT: '',\n COINMETRICS: '',\n HUGGINGFACE: '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',\n};\n\nconst sleep = (ms: number) => new Promise(r => setTimeout(r, ms));\n\nclass HttpError extends Error {\n constructor(public status: number, public url: string, public body?: string) {\n super(`HTTP ${status} for ${url}`);\n }\n}\n\nfunction buildURL(base: string, path = '', params?: Record): string {\n const hasQ = path.includes('?');\n const url = base.replace(/\\/+$/, '') + '/' + path.replace(/^\\/+/, '');\n if (!params || Object.keys(params).length === 0) return url;\n const qs = new URLSearchParams();\n for (const [k, v] of Object.entries(params)) {\n if (v === undefined || v === null) continue;\n qs.set(k, String(v));\n }\n return url + (hasQ ? '&' : '?') + qs.toString();\n}\n\nasync function fetchRaw(\n url: string,\n opts: { headers?: Record; timeoutMs?: number; retries?: number; retryDelayMs?: number; body?: any; method?: 'GET'|'POST' } = {}\n): Promise {\n const { headers = {}, timeoutMs = 12000, retries = 1, retryDelayMs = 600, body, method = 'GET' } = opts;\n let lastErr: any;\n for (let attempt = 0; attempt <= retries; attempt++) {\n const ac = new AbortController();\n const id = setTimeout(() => ac.abort(), timeoutMs);\n try {\n const res = await fetch(url, { headers, signal: ac.signal, method, body });\n clearTimeout(id);\n if (!res.ok) {\n const text = await res.text().catch(() => '');\n if (res.status === 429 && attempt < retries) {\n await sleep(retryDelayMs * (attempt + 1));\n continue;\n }\n throw new HttpError(res.status, url, text);\n }\n return res;\n } catch (e) {\n clearTimeout(id);\n lastErr = e;\n if (attempt < retries) { await sleep(retryDelayMs * (attempt + 1)); continue; }\n }\n }\n throw lastErr;\n}\n\nasync function fetchJSON(\n url: string,\n opts: { headers?: Record; timeoutMs?: number; retries?: number; retryDelayMs?: number; body?: any; method?: 'GET'|'POST' } = {}\n): Promise {\n const res = await fetchRaw(url, opts);\n const ct = res.headers.get('content-type') || '';\n if (ct.includes('json')) return res.json() as Promise;\n const text = await res.text();\n try { return JSON.parse(text) as T; } catch { return text as unknown as T; }\n}\n\nfunction ensureNonEmpty(obj: any, label: string) {\n if (obj == null) throw new Error(`${label}: empty response`);\n if (Array.isArray(obj) && obj.length === 0) throw new Error(`${label}: empty array`);\n if (typeof obj === 'object' && !Array.isArray(obj) && Object.keys(obj).length === 0)\n throw new Error(`${label}: empty object`);\n}\n\nfunction normalizeSymbol(q: string) { return q.trim().toLowerCase(); }\n\nfunction parseCSV(text: string): any[] {\n const lines = text.split(/\\r?\\n/).filter(Boolean);\n if (lines.length < 2) return [];\n const header = lines[0].split(',').map((s) => s.trim());\n const out: any[] = [];\n for (let i = 1; i < lines.length; i++) {\n const cols = lines[i].split(',').map((s) => s.trim());\n const row: any = {};\n header.forEach((h, idx) => { row[h] = cols[idx]; });\n out.push(row);\n }\n return out;\n}\n\nfunction parseRssSimple(xml: string, source: string, limit = 20): NewsItem[] {\n const items: NewsItem[] = [];\n const chunks = xml.split(/- ]/i).slice(1);\n for (const raw of chunks) {\n const item = raw.split(/<\\/item>/i)[0] || '';\n const get = (tag: string) => {\n const m = item.match(new RegExp(`<${tag}[^>]*>([\\\\s\\\\S]*?)${tag}>`, 'i'));\n return m ? m[1].replace(//g, '').trim() : undefined;\n };\n const title = get('title'); const link = get('link') || get('guid'); const pub = get('pubDate') || get('updated') || get('dc:date');\n if (title && link) items.push({ title, link, publishedAt: pub, source });\n if (items.length >= limit) break;\n }\n return items;\n}\n\n/* ===================== BASE RESOURCES ===================== */\n\nexport const resources: CryptoResource[] = [\n // Market\n { id: 'coinpaprika', category: 'market', name: 'CoinPaprika', baseUrl: 'https://api.coinpaprika.com/v1', free: true, endpoints: {\n search: { path: '/search', sampleParams: { q: 'bitcoin', c: 'currencies', limit: 1 } },\n tickerById: { path: '/tickers/{id}', sampleParams: { quotes: 'USD' } },\n }},\n { id: 'coincap', category: 'market', name: 'CoinCap', baseUrl: 'https://api.coincap.io/v2', free: true, endpoints: {\n assets: { path: '/assets', sampleParams: { search: 'bitcoin', limit: 1 } },\n assetById: { path: '/assets/{id}' },\n }},\n { id: 'coingecko', category: 'market', name: 'CoinGecko', baseUrl: 'https://api.coingecko.com/api/v3', free: true, endpoints: {\n simplePrice: { path: '/simple/price?ids={ids}&vs_currencies={fiats}' },\n }},\n { id: 'defillama', category: 'market', name: 'DefiLlama (Prices)', baseUrl: 'https://coins.llama.fi', free: true, endpoints: {\n pricesCurrent: { path: '/prices/current/{coins}' },\n }},\n { id: 'binance', category: 'market', name: 'Binance Public', baseUrl: 'https://api.binance.com', free: true, endpoints: {\n klines: { path: '/api/v3/klines?symbol={symbol}&interval={interval}&limit={limit}' },\n ticker: { path: '/api/v3/ticker/price?symbol={symbol}' },\n }},\n { id: 'cryptocompare', category: 'market', name: 'CryptoCompare', baseUrl: 'https://min-api.cryptocompare.com', free: true, endpoints: {\n histominute: { path: '/data/v2/histominute?fsym={fsym}&tsym={tsym}&limit={limit}&api_key=' + EMBEDDED_KEYS.CRYPTOCOMPARE },\n histohour: { path: '/data/v2/histohour?fsym={fsym}&tsym={tsym}&limit={limit}&api_key=' + EMBEDDED_KEYS.CRYPTOCOMPARE },\n histoday: { path: '/data/v2/histoday?fsym={fsym}&tsym={tsym}&limit={limit}&api_key=' + EMBEDDED_KEYS.CRYPTOCOMPARE },\n }},\n { id: 'cmc', category: 'market', name: 'CoinMarketCap', baseUrl: 'https://pro-api.coinmarketcap.com/v1', free: false, endpoints: {\n quotes: { path: '/cryptocurrency/quotes/latest?symbol={symbol}', authLocation: 'header', authName: 'X-CMC_PRO_API_KEY', authValue: EMBEDDED_KEYS.CMC },\n }},\n\n // News\n { id: 'coinstats_news', category: 'news', name: 'CoinStats News', baseUrl: 'https://api.coinstats.app', free: true, endpoints: { feed: { path: '/public/v1/news' } }},\n { id: 'cryptopanic', category: 'news', name: 'CryptoPanic', baseUrl: 'https://cryptopanic.com', free: true, endpoints: { public: { path: '/api/v1/posts/?public=true' } }},\n { id: 'rss_cointelegraph', category: 'news', name: 'Cointelegraph RSS', baseUrl: 'https://cointelegraph.com', free: true, endpoints: { feed: { path: '/rss' } }},\n { id: 'rss_coindesk', category: 'news', name: 'CoinDesk RSS', baseUrl: 'https://www.coindesk.com', free: true, endpoints: { feed: { path: '/arc/outboundfeeds/rss/?outputType=xml' } }},\n { id: 'rss_decrypt', category: 'news', name: 'Decrypt RSS', baseUrl: 'https://decrypt.co', free: true, endpoints: { feed: { path: '/feed' } }},\n\n // Sentiment / F&G\n { id: 'altme_fng', category: 'sentiment', name: 'Alternative.me F&G', baseUrl: 'https://api.alternative.me', free: true, endpoints: {\n latest: { path: '/fng/', sampleParams: { limit: 1 } },\n history: { path: '/fng/', sampleParams: { limit: 30 } },\n }},\n { id: 'cfgi_v1', category: 'sentiment', name: 'CFGI API v1', baseUrl: 'https://api.cfgi.io', free: true, endpoints: {\n latest: { path: '/v1/fear-greed' },\n }},\n { id: 'cfgi_legacy', category: 'sentiment', name: 'CFGI Legacy', baseUrl: 'https://cfgi.io', free: true, endpoints: {\n latest: { path: '/api' },\n }},\n\n // On-chain / explorers\n { id: 'etherscan_primary', category: 'block_explorer', name: 'Etherscan', baseUrl: 'https://api.etherscan.io/api', free: false, endpoints: {\n balance: { path: '/?module=account&action=balance&address={address}&tag=latest&apikey=' + EMBEDDED_KEYS.ETHERSCAN },\n }},\n { id: 'etherscan_backup', category: 'block_explorer', name: 'Etherscan Backup', baseUrl: 'https://api.etherscan.io/api', free: false, endpoints: {\n balance: { path: '/?module=account&action=balance&address={address}&tag=latest&apikey=' + EMBEDDED_KEYS.ETHERSCAN_BACKUP },\n }},\n { id: 'blockscout_eth', category: 'block_explorer', name: 'Blockscout (ETH)', baseUrl: 'https://eth.blockscout.com', free: true, endpoints: {\n balanc",
"note": "included as small text"
}
],
"discovered_keys": {
"etherscan": [
"SZHYFZK2RR8H9TIMJBVW54V4H81K2Z2KR2",
"T6IR8VJHX2NE6ZJW2S3FDVN1TYG4PYYI45"
],
"bscscan": [
"K62RKHGXTDCG53RU4MCG6XABIMJKTN19IT"
],
"tronscan": [
"7ae72726-bffe-4e74-9c33-97b761eeea21"
],
"coinmarketcap": [
"04cf4b5b-9868-465c-8ba0-9f2e78c92eb1",
"b54bcf4d-1bca-4e8e-9a24-22ff2c3d462c"
],
"newsapi": [
"pub_346789abc123def456789ghi012345jkl"
],
"cryptocompare": [
"e79c8e6d4c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f"
],
"huggingface": [
"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"
]
},
"notes": "This file was auto-generated. Keys/tokens are present as found in uploaded sources. Secure them as you wish."
}