{"openapi":"3.1.0","info":{"title":"thefux","description":"Thefux Provider","version":"0.5.1+gd980acc"},"paths":{"/v1/info":{"get":{"summary":"Info","operationId":"info_v1_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Info V1 Info Get"}}}}}}},"/v1/providers":{"get":{"summary":"Providers","operationId":"providers_v1_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin":{"get":{"summary":"Admin Redirect","operationId":"admin_redirect_admin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/models/paths":{"get":{"summary":"Model Paths","description":"All models with every upstream provider path they are reachable through.","operationId":"model_paths_v1_models_paths_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Model Paths V1 Models Paths Get"}}}}}}},"/v1/models/paths/model":{"get":{"summary":"Model Paths For Model","description":"Paths for a single model.\n\nUses a query parameter (``?model_id=...``) under a fully static route so\nmodel ids containing ``/`` (e.g. ``anthropic/claude-opus-4.6``) need no URL\nencoding and there is no dynamic-route ambiguity.","operationId":"model_paths_for_model_v1_models_paths_model_get","parameters":[{"name":"model_id","in":"query","required":true,"schema":{"type":"string","title":"Model Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Model Paths For Model V1 Models Paths Model Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/models":{"get":{"summary":"Models","description":"Get all available models from all providers with database overrides applied.","operationId":"models_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Models Models Get"}}}}}}},"/v1/models":{"get":{"summary":"Models","description":"Get all available models from all providers with database overrides applied.","operationId":"models_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Models V1 Models Get"}}}}}}},"/v1/balance/create":{"post":{"summary":"Create Balance From Body","operationId":"create_balance_from_body_v1_balance_create_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Balance From Body V1 Balance Create Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Create Balance","operationId":"create_balance_v1_balance_create_get","deprecated":true,"parameters":[{"name":"initial_balance_token","in":"query","required":true,"schema":{"type":"string","title":"Initial Balance Token"}},{"name":"validity_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Validity Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Balance V1 Balance Create Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/info":{"get":{"summary":"Wallet Info","operationId":"wallet_info_v1_balance_info_get","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Wallet Info V1 Balance Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/topup":{"post":{"summary":"Topup Wallet Endpoint","operationId":"topup_wallet_endpoint_v1_balance_topup_post","parameters":[{"name":"cashu_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cashu Token"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/TopupRequest"},{"type":"null"}],"title":"Topup Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"}]},"title":"Response Topup Wallet Endpoint V1 Balance Topup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/refund":{"post":{"summary":"Refund Wallet Endpoint","operationId":"refund_wallet_endpoint_v1_balance_refund_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-cashu","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Cashu"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RefundRequest"},{"type":"null"}],"title":"Refund Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/history":{"get":{"summary":"Wallet History","operationId":"wallet_history_v1_balance_history_get","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"},{"type":"null"}]}}},"title":"Response Wallet History V1 Balance History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/donate":{"post":{"summary":"Donate","operationId":"donate_v1_balance_donate_post","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}},{"name":"ref","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"string","title":"Response Donate V1 Balance Donate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lightning/invoice":{"post":{"summary":"Create Invoice","operationId":"create_invoice_lightning_invoice_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lightning/invoice/{invoice_id}/status":{"get":{"summary":"Get Invoice Status","operationId":"get_invoice_status_lightning_invoice__invoice_id__status_get","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lightning/recover":{"post":{"summary":"Recover Invoice","operationId":"recover_invoice_lightning_recover_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRecoverRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/lightning/invoice":{"post":{"summary":"Create Invoice","operationId":"create_invoice_v2_lightning_invoice_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/lightning/invoice/{invoice_id}/status":{"get":{"summary":"Get Invoice Status","operationId":"get_invoice_status_v2_lightning_invoice__invoice_id__status_get","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/lightning/recover":{"post":{"summary":"Recover Invoice","operationId":"recover_invoice_v2_lightning_recover_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRecoverRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/providers/":{"get":{"summary":"Get Providers","description":"Return cached providers. If include_json, return provider+health; otherwise provider only.\nOptional filter by pubkey.","operationId":"get_providers_v1_providers__get","parameters":[{"name":"include_json","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Json"}},{"name":"pubkey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pubkey"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","additionalProperties":true}},"title":"Response Get Providers V1 Providers  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/{path}":{"post":{"summary":"Proxy","description":"Run proxy setup in a short request session, never across response streaming.","operationId":"proxy__path__post","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Proxy","description":"Run proxy setup in a short request session, never across response streaming.","operationId":"proxy__path__post","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BalanceCreateRequest":{"properties":{"initial_balance_token":{"type":"string","title":"Initial Balance Token"},"validity_date":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Validity Date"}},"type":"object","required":["initial_balance_token"],"title":"BalanceCreateRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InvoiceCreateRequest":{"properties":{"amount_sats":{"type":"integer","maximum":1000000.0,"exclusiveMinimum":0.0,"title":"Amount Sats","description":"Amount in satoshis"},"purpose":{"type":"string","pattern":"^(create|topup)$","title":"Purpose","description":"create or topup","default":"create"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key","description":"Deprecated: legacy field for topup. Prefer Authorization header."},"validity_date":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Validity Date"}},"type":"object","required":["amount_sats"],"title":"InvoiceCreateRequest"},"InvoiceCreateResponse":{"properties":{"invoice_id":{"type":"string","title":"Invoice Id"},"bolt11":{"type":"string","title":"Bolt11"},"amount_sats":{"type":"integer","title":"Amount Sats"},"expires_at":{"type":"integer","title":"Expires At"},"payment_hash":{"type":"string","title":"Payment Hash"}},"type":"object","required":["invoice_id","bolt11","amount_sats","expires_at","payment_hash"],"title":"InvoiceCreateResponse"},"InvoiceRecoverRequest":{"properties":{"bolt11":{"type":"string","title":"Bolt11","description":"BOLT11 invoice string"}},"type":"object","required":["bolt11"],"title":"InvoiceRecoverRequest"},"InvoiceStatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"amount_sats":{"type":"integer","title":"Amount Sats"},"paid_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Paid At"},"created_at":{"type":"integer","title":"Created At"},"expires_at":{"type":"integer","title":"Expires At"}},"type":"object","required":["status","amount_sats","created_at","expires_at"],"title":"InvoiceStatusResponse"},"RefundRequest":{"properties":{"lightning_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lightning Address"}},"type":"object","title":"RefundRequest"},"TopupRequest":{"properties":{"cashu_token":{"type":"string","title":"Cashu Token"}},"type":"object","required":["cashu_token"],"title":"TopupRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}