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