KSVC's AI Intern — pay-per-query quant trading model data API with X-402 micropayments.
- 7 quant models, 170 tickers across US and Taiwan markets
- Dual-token payments — USDC or $KIRK on Base
- 30% discount when paying with $KIRK
- A2A compatible — agent card at
/.well-known/agent.json
| Environment |
URL |
| Mainnet |
https://kirk-api-production.up.railway.app |
| Testnet |
https://kirk-api-testnet-production.up.railway.app |
| Docs |
https://kirk-api-production.up.railway.app/docs |
| Method |
Path |
Description |
| GET |
/health |
Health check |
| GET |
/models |
List all 7 models |
| GET |
/info |
API info, pricing, token addresses |
| GET |
/.well-known/agent.json |
A2A agent discovery card |
| GET |
/docs |
Swagger UI |
| Method |
Path |
Description |
| GET |
/models/:model/summary |
Quick snapshot — MTD return, top/worst performer |
| GET |
/models/:model/info |
Model metadata and performance |
| GET |
/leaderboard |
All models ranked by MTD return |
| Method |
Path |
Description |
| GET |
/models/:model/performance |
Full performance metrics |
| GET |
/models/:model/holdings |
All holdings sorted by return |
| GET |
/models/:model/holdings/top |
Top N holdings (default 10) |
| GET |
/models/:model/holdings/:ticker |
Single holding detail with equity series |
| GET |
/models/:model/stats |
Aggregate statistics |
| Method |
Path |
Description |
| GET |
/models/:model/history/monthly |
Monthly return history with win/loss stats |
| GET |
/models/:model/tradebook |
Full position ledger with entry/exit P&L |
| GET |
/models/:model/positions |
Currently open positions |
| GET |
/compare |
Compare models (query: ?models=usa-model1,usa-model2) |
| Method |
Path |
Description |
| GET |
/models/:model/trades/recent |
Last 20 filled orders |
| GET |
/models/:model/trades/filled |
All filled orders |
| GET |
/models/:model/trades/pending |
Open/pending orders |
All paid endpoints use the X-402 protocol. Without payment, they return 402 Payment Required with two options:
| Token |
Scheme |
Contract |
Discount |
| USDC |
exact |
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
— |
| $KIRK |
upto |
0x73b83F8553480e8A8bb56B53618d5e70C8051e37 |
30% off |
Payment is facilitated by Daydreams. Treasury: 0x54376e042acd7cf3bea1a40aff9c33b47e7ec5de
| Region |
Models |
| US |
usa-model1 through usa-model5 (~130 equities) |
| Taiwan |
twse-model1, twse-model2 (~40 stocks) |
bun install
cp .env.example .env
# Set KSVC_API_BASE in .env
bun run dev
# Health check
curl https://kirk-api-production.up.railway.app/health
# List models (free)
curl https://kirk-api-production.up.railway.app/models
# Paid endpoint (returns 402 with payment options)
curl https://kirk-api-production.up.railway.app/models/usa-model1/summary