diff --git a/README.md b/README.md index f86ad38..1c2a381 100644 --- a/README.md +++ b/README.md @@ -1,47 +1,50 @@ # StellarKit API π +A lightweight REST API for Stellar that turns Horizon blockchain data into easy-to-use developer endpoints. It helps applications fetch account balances, transaction history, fee estimates, and network status without needing deep Stellar protocol knowledge. +
- English πΊπΈ | FranΓ§ais π«π· | EspaΓ±ol πͺπΈ
+
+
+
+
+ English πΊπΈ | FranΓ§ais π«π· | EspaΓ±ol πͺπΈ +
-[](https://opensource.org/licenses/MIT) -[](https://nodejs.org/) -[](https://stellar.org) -[](CONTRIBUTING.md) --- ## What is StellarKit API? -StellarKit API is a wrapper around the Stellar Horizon API, built with Express.js and the official `@stellar/stellar-sdk` library. It normalizes Horizon responses, provides a clean REST structure, and adds convenience endpoints for the most common Stellar developer workflows. - -This project is ideal for: +StellarKit API is a lightweight, production-ready Express service for exploring Stellar network data through a clean REST interface. It combines Horizon data with Soroban RPC support, normalizes common responses, and exposes practical endpoints for account analysis, fee estimation, asset intelligence, DEX and liquidity-pool data, claimable balances, and live streaming. -- Web and mobile developers building on Stellar -- Server-side services consuming Stellar account and transaction data -- Wallet providers that need reliable fee estimation and account summaries -- Applications requiring typed API responses via bundled TypeScript definitions +This project is especially useful for teams and developers who need: ---- +- Web and mobile apps that need Stellar account, transaction, and network data +- Backend services aggregating balances, reserves, activity, and risk signals +- Wallets and custodians that need fee estimates, multisig insights, and account health checks +- Developers building with TypeScript who want typed responses and a predictable API surface -## Key Features +### Highlights -- π **Network status and ledger health** -- π° **Dynamic fee estimation** for optimal transaction pricing -- π₯ **Account detail aggregation** including balances, signers, and thresholds -- π **Paginated transaction history** and operation history per account -- πͺ **Asset metadata search** and issuer lookup -- π« **Built-in security middleware** with rate limiting, helmet headers, CORS, and HPP -- π§ͺ **Test coverage** using Jest and Supertest -- π¦ **Bundled TypeScript types** for safe integration in TypeScript projects +- π **Network and ledger health** for testnet and mainnet +- πΈ **Dynamic fee estimation** with surge and trend analysis +- π€ **Comprehensive account summaries** including balances, reserves, signers, and risk signals +- π **Transaction and operation history** with batch transaction status checks +- πͺ **Asset metadata, holder analytics, supply views, and issuer verification** +- π **DEX, liquidity pool, and arbitrage insights** +- π **Built-in security and resilience** with rate limiting, Helmet, CORS, HPP, API key support, and caching +- β‘ **Live streaming** through WebSocket and Server-Sent Events for ledgers, transactions, and payments +- π§± **Soroban contract inspection** for deployed contract metadata and storage +- π§ͺ **Jest/Supertest coverage** and bundled TypeScript definitions --- ## Documentation -- [SDK Migration Guide](docs/sdk-migration.md) β migrating from the JavaScript SDK to the TypeScript SDK +- [SDK Migration Guide](docs/sdk-migration.md) β moving from the JavaScript SDK to the TypeScript SDK - [SDK README](sdk/README.md) β JavaScript client usage and method reference - [Getting Started Guide](docs/getting-started.md) - Set up the project and make your first API calls - [API Design Guidelines](docs/api-design.md) - Design conventions and response patterns @@ -197,7 +200,7 @@ See [docs/soroban.md](docs/soroban.md) for a full walkthrough with curl examples --- -## Documentation +## Additional Documentation - [docs/soroban.md](docs/soroban.md) β Soroban contract endpoints: what Soroban is, how contract IDs work, and how to inspect deployed contracts via `/soroban/contract/:id` and `/soroban/contract/:id/storage`.