HashScope
HashScope is an API platform built on the HSK blockchain that bridges real-world data with blockchain technology, rewarding data contributors with HSK tokens. Our platform provides high-quality, real-time data through standardized APIs, while also offering Model Context Protocol (MCP) integration to make this data easily accessible to AI agents.
Users connect their HSK wallets, stake HSK tokens, and receive API keys to access our comprehensive data ecosystem. As they consume data, fees are automatically deducted from their staked tokens and distributed to data providers, creating a sustainable data economy. This token-based incentive system enables us to connect the physical world with blockchain by rewarding those who contribute valuable data sources.
Our core mission is to create a decentralized bridge between real-world information and blockchain technology, using HSK as the connecting medium. By standardizing diverse data sources—from cryptocurrency markets and social media trends to blockchain project updates—we empower AI agents to make informed decisions while ensuring data providers are fairly compensated for their contributions.
- Frontend: Next.js, Tailwind CSS, Shadcn UI, Figma
- Backend: FastAPI, SQLite3, Open Zeppelin, Solidity
- Other: Vercel, AWS EC2, Git
-
Frontend: HashScope Website
-
Backend API: Backend Endpoint
-
API Docs: Swagger Doc
-
SmartContract: SmartContract
-
Project Deck: Google Slides link
- SeungWoon Song - PM, Backend (0xDbCeE5A0F6804f36930EAA33aB4cef11a7964398)
- Hyerin Kim - Design, Frontend (0xdEcBa0C08ca92D302Ad037AB708496466B89bc23)
-
User Registration & Authentication
- Users connect their HSK wallet
- Backend verifies wallet signature
- User receives JWT token for authentication
-
API Key Management
- Users can generate API keys through the dashboard
- Each API key has a unique ID and secret
- Rate limits can be configured per API key
-
Token Staking & Fee Deduction
- Users stake HSK tokens to use the API
- Fees are automatically deducted based on API usage
- Every 10 API calls result in a 0.01 HSK deduction(Only for PoC, will be changed later)
-
API Usage & Monitoring
- Users can monitor their API usage through the dashboard
- Usage statistics include call counts, endpoints, and costs
- Historical data is available for analysis
| Endpoint | Method | Description |
|---|---|---|
/crypto/btc/usd |
GET | Get BTC price in USD from Binance |
/crypto/btc/krw |
GET | Get BTC price in KRW from Upbit |
/crypto/usdt/krw |
GET | Get USDT price in KRW from Upbit |
/crypto/kimchi-premium |
GET | Get kimchi premium percentage between Korean and global markets |
/crypto/prices |
GET | Get major cryptocurrency prices (BTC, ETH, XRP) |
| Endpoint | Method | Description |
|---|---|---|
/social/trump |
GET | Get Donald Trump's latest posts from Truth Social |
/social/elon |
GET | Get Elon Musk's latest posts from X (Twitter) |
/social/x/trends |
GET | Get current trending topics on X (Twitter) |
| Endpoint | Method | Description |
|---|---|---|
/derivatives/funding-rates |
GET | Get current funding rates for major cryptocurrency futures markets |
/derivatives/open-interest |
GET | Get open interest ratios for major cryptocurrency derivatives |
| Endpoint | Method | Description |
|---|---|---|
/projects/hsk |
GET | Get latest updates and developments from HashKey Chain |
/projects/ethereum/standards |
GET | Get information about new Ethereum standards and proposals |
/projects/solana |
GET | Get latest updates and developments from Solana blockchain |
| Endpoint | Method | Description |
|---|---|---|
/opensource/bitcoin |
GET | Get latest pull requests, stars, and activities from Bitcoin Core repository |
/opensource/ethereum |
GET | Get latest pull requests, stars, and activities from Ethereum Core repositories |
| Endpoint | Method | Description |
|---|---|---|
/api-keys |
POST | Create a new API key |
/api-keys |
GET | List all API keys |
/api-keys/{key_id} |
GET | Get API key details |
/api-keys/{key_id}/usage |
GET | Get API key usage statistics |
/api-keys/{key_id}/history |
GET | Get detailed API usage history |
The HashScope platform utilizes smart contracts built on the HSK blockchain to handle token staking, fee deduction, and reward distribution.
The main contract that handles HSK token deposits and usage fee deductions.
Key Features:
- Native HSK deposits and withdrawals
- Automated fee deduction based on API usage
- Event emission for tracking transactions
- Owner-controlled fee adjustment
Main Functions:
deposit(): Allows users to deposit HSK tokenswithdraw(uint256 amount): Allows users to withdraw their HSK tokensdeductForUsage(address user, uint256 amount, address recipient): Deducts usage fees from user's balancegetBalance(address user): Returns the user's current balance
Events:
Deposited(address indexed user, uint256 amount)Withdrawn(address indexed user, uint256 amount)UsageDeducted(address indexed user, uint256 amount, address recipient)
The smart contracts are deployed on the HSK blockchain at the following addresses:
- HSKDeposit:
0x0D313B22601E7AD450DC9b8b78aB0b0014022269




