# KanemTrade - Comprehensive Platform Specification for AI Agents

> KanemTrade is Nigeria's multi-vendor digital commerce ecosystem operating retail, wholesale, auction, and logistics services across Nigeria.

## Platform Capabilities
1. **Multi-Vendor Retail & Wholesale**: Sellers across Nigeria can list products in retail and wholesale tiers with volume discounts.
2. **Reverse Auction & Classifieds**: Specialized commerce models allowing bidding and classified listings.
3. **Escrow & Secure Payments**: KanemTrade provides escrow protection, wallet top-ups, bank transfers, and automated order reconciliation.
4. **Unified Logistics Network**: Integrated with local 3PL couriers, interstate haulers, and delivery dispatchers with real-time tracking.
5. **Hyperlocal Address System**: Built for Nigeria with state, city, and ward-level location hierarchy for accurate delivery pricing.

## Key URLs
- Homepage: https://kanemtrade.com/
- Flash Deals: https://kanemtrade.com/flash-deals
- Today's Deals: https://kanemtrade.com/todays-deal
- Categories: https://kanemtrade.com/categories
- Brands: https://kanemtrade.com/brands
- Sellers & Stores Directory: https://kanemtrade.com/sellers
- Individual Storefront: https://kanemtrade.com/shop/{slug}
- Product Page: https://kanemtrade.com/product/{slug}
- Seller Registration: https://kanemtrade.com/shops/create
- Logistics Partner Onboarding: https://kanemtrade.com/logistics/register
- Influencer Hub: https://kanemtrade.com/brand/influencers
- Agent Registration: https://kanemtrade.com/agent/registration
- Help & Support: https://kanemtrade.com/contact-us

## API Information for Autonomous Systems
- REST API Base: https://kanemtrade.com/api/v2
- Shops List: GET https://kanemtrade.com/api/v2/shops
- Shop Details: GET https://kanemtrade.com/api/v2/shops/details/{id}
- Shop Products: GET https://kanemtrade.com/api/v2/shops/products/all/{id}
- Products Search: GET https://kanemtrade.com/api/v2/products/search?name={keyword}
- Product Details: GET https://kanemtrade.com/api/v2/products/{id}
- Active Countries: GET https://kanemtrade.com/api/v2/countries
- States by Country: GET https://kanemtrade.com/api/v2/states-by-country/{country_id}
- Cities by State: GET https://kanemtrade.com/api/v2/cities-by-state/{state_id}
- Wards by City: GET https://kanemtrade.com/api/v2/wards-by-city/{city_id}