{"openapi":"3.1.0","info":{"title":"Space Kitty Archive API","version":"1.0.0","description":"Citation-verified research dossiers and a curated index of frontier research papers and clinical trials. Discovery is free; full dossiers and topic research packs cost $0.20 per request via x402 (USDC on Base Sepolia (testnet)).","contact":{"name":"Space Kitty Archive","url":"https://space-kitty.com/about","email":"hello@space-kitty.com"},"termsOfService":"https://space-kitty.com/terms","x-guidance":"Start free: GET /api/v1/search?q=<terms> or GET /api/v1/topics, then GET /api/v1/dossiers/{slug}/preview to inspect a dossier. To buy, GET /api/v1/dossiers/{slug} (or /api/v1/topics/{slug}/pack); the 402 response carries x402 terms ($0.20 USDC on eip155:84532, scheme exact). Retry with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1). Your client's per-payment cap must allow 200000 atomic USDC. Nothing is charged for 404s or failed requests. Send Accept: text/markdown on the dossier endpoint for Markdown. MCP: https://space-kitty.com/mcp.","x-llms-txt":"https://space-kitty.com/llms.txt"},"servers":[{"url":"https://space-kitty.com"}],"x-mcp":{"url":"https://space-kitty.com/mcp","transport":"streamable-http"},"paths":{"/api/v1":{"get":{"operationId":"apiIndex","summary":"API index with pricing and statistics","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/domains":{"get":{"operationId":"listDomains","summary":"List research domains","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/v1/topics":{"get":{"operationId":"listTopics","summary":"List topics with paper counts and dossier availability","security":[],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"},"description":"Domain slug filter"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topics":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/v1/topics/{slug}":{"get":{"operationId":"getTopic","summary":"Topic overview: dossier preview, most influential and newest papers","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Dossier or topic slug, e.g. quantum-error-correction"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"object"},"dossier":{"anyOf":[{"$ref":"#/components/schemas/DossierSummary"},{"type":"null"}]},"top_papers":{"type":"array","items":{"$ref":"#/components/schemas/PaperBrief"}},"newest_papers":{"type":"array","items":{"$ref":"#/components/schemas/PaperBrief"}}}}}}},"404":{"description":"Unknown topic"}}}},"/api/v1/topics/{slug}/papers":{"get":{"operationId":"listTopicPapers","summary":"Ranked paper metadata for a topic (abstracts where licensed)","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Dossier or topic slug, e.g. quantum-error-correction"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["top","recent"]},"description":"Ranking"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Offset"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["preprint","article","review","trial"]},"description":"Record type"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"papers":{"type":"array","items":{"type":"object"}},"next":{"type":["string","null"]}}}}}},"404":{"description":"Unknown topic"}}}},"/api/v1/topics/{slug}/pack":{"get":{"operationId":"getResearchPack","summary":"Topic research pack: dossier + 50 most influential + 25 newest papers + trials (paid, $0.20)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Dossier or topic slug, e.g. quantum-error-correction"},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload (base64 JSON)."},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v1 payment payload (base64 JSON)."},{"name":"X-Archive-Receipt","in":"header","required":false,"schema":{"type":"string"},"description":"Receipt from an earlier purchase of the same resource (free re-download for 24h)."}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid content. PAYMENT-RESPONSE (v2) or X-PAYMENT-RESPONSE (v1) carries the settlement; X-Archive-Receipt allows a free re-download for 24h.","content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"object"},"dossier":{"type":["object","null"]},"top_papers":{"type":"array","items":{"type":"object"}},"newest_papers":{"type":"array","items":{"type":"object"}},"trials":{"type":"array","items":{"type":"object"}}}}}},"headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"}},"X-Archive-Receipt":{"schema":{"type":"string"}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED (base64 JSON, x402 v2) holds the terms; the JSON body repeats them in v1 form (accepts) with a free preview.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 PaymentRequired object"}},"content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}},"preview":{"type":"object"}}}}}},"404":{"description":"Unknown resource. Nothing is charged."}}}},"/api/v1/search":{"get":{"operationId":"search","summary":"Full-text search over papers, trials and dossiers","security":[],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":300},"description":"Query; quote exact phrases"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["all","papers","dossiers"]},"description":"Result types"},{"name":"topic","in":"query","required":false,"schema":{"type":"string"},"description":"Topic slug filter"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["preprint","article","review","trial"]},"description":"Record type"},{"name":"year_from","in":"query","required":false,"schema":{"type":"integer"},"description":"Earliest year"},{"name":"year_to","in":"query","required":false,"schema":{"type":"integer"},"description":"Latest year"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Offset"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"papers":{"type":"array","items":{"$ref":"#/components/schemas/PaperBrief"}},"dossiers":{"type":"array","items":{"$ref":"#/components/schemas/DossierSummary"}},"next":{"type":["string","null"]}}}}}},"400":{"description":"Missing query"}}}},"/api/v1/papers/{id}":{"get":{"operationId":"getPaper","summary":"One paper or trial record with provenance and license","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"e.g. arxiv:2408.13687, doi:10.1038/…, nct:NCT05000000"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaperBrief"}}}},"404":{"description":"Unknown id"}}}},"/api/v1/latest":{"get":{"operationId":"latest","summary":"Newest additions","security":[],"parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string"},"description":"Topic slug"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50},"description":"Count"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"papers":{"type":"array","items":{"$ref":"#/components/schemas/PaperBrief"}}}}}}}}}},"/api/v1/dossiers":{"get":{"operationId":"listDossiers","summary":"Dossier catalog with summaries, statistics and prices","security":[],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"},"description":"Domain slug"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"dossiers":{"type":"array","items":{"$ref":"#/components/schemas/DossierSummary"}}}}}}}}}},"/api/v1/dossiers/{slug}/preview":{"get":{"operationId":"previewDossier","summary":"Free dossier preview: summary, contents, statistics, sample claims","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Dossier or topic slug, e.g. quantum-error-correction"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DossierSummary"}}}},"404":{"description":"Unknown dossier"}}}},"/api/v1/dossiers/{slug}":{"get":{"operationId":"getDossier","summary":"Full research dossier: Markdown + claims mapped to citations, benchmarks, timeline, open problems, glossary, bibliography (paid, $0.20)","description":"JSON by default; send Accept: text/markdown for Markdown.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Dossier or topic slug, e.g. quantum-error-correction"},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload (base64 JSON)."},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v1 payment payload (base64 JSON)."},{"name":"X-Archive-Receipt","in":"header","required":false,"schema":{"type":"string"},"description":"Receipt from an earlier purchase of the same resource (free re-download for 24h)."}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid content. PAYMENT-RESPONSE (v2) or X-PAYMENT-RESPONSE (v1) carries the settlement; X-Archive-Receipt allows a free re-download for 24h.","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"markdown":{"type":"string"},"claims":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"citations":{"type":"array","items":{"type":"string"}}}}},"timeline":{"type":"array","items":{"type":"object"}},"benchmarks":{"type":"array","items":{"type":"object"}},"open_problems":{"type":"array","items":{"type":"object"}},"glossary":{"type":"array","items":{"type":"object"}},"bibliography":{"type":"array","items":{"$ref":"#/components/schemas/PaperBrief"}}}}}},"headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"}},"X-Archive-Receipt":{"schema":{"type":"string"}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED (base64 JSON, x402 v2) holds the terms; the JSON body repeats them in v1 form (accepts) with a free preview.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 PaymentRequired object"}},"content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object"}},"preview":{"type":"object"}}}}}},"404":{"description":"Unknown resource. Nothing is charged."}}}}},"components":{"schemas":{"PaperBrief":{"type":"object","properties":{"id":{"type":"string","examples":["arxiv:2408.13687"]},"kind":{"type":"string","enum":["preprint","article","review","trial","report"]},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"author_count":{"type":"integer"},"year":{"type":["integer","null"]},"published":{"type":["string","null"],"format":"date"},"venue":{"type":["string","null"]},"cited_by":{"type":["integer","null"]},"doi":{"type":["string","null"]},"arxiv_id":{"type":["string","null"]},"nct_id":{"type":["string","null"]},"source_url":{"type":"string","format":"uri"},"archive_url":{"type":"string","format":"uri"}},"required":["id","kind","title","source_url"]},"DossierSummary":{"type":"object","properties":{"slug":{"type":"string"},"topic":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"version":{"type":"integer"},"updated_at":{"type":"string"},"stats":{"type":"object"},"verification":{"type":"object"},"price":{"type":"object"},"preview_url":{"type":"string","format":"uri"},"purchase_url":{"type":"string","format":"uri"}},"required":["slug","title","summary"]}}}}