{"openapi":"3.1.0","info":{"title":"Crypto Wallet API","version":"0.1.0","description":"Crypto wallet security and self-custody education: hot vs. cold wallets, seed-phrase security, hardware wallet basics, wallet-drain scam patterns, a self-custody readiness score, and a custodial vs. non-custodial glossary — all local, hand-curated, no upstream calls.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://cryptowallet.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/cryptowallet/docs"},"termsOfService":"https://connectorbay.com/cryptowallet/terms"},"servers":[{"url":"https://cryptowallet.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/cryptowallet/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/wallet_type_guide":{"post":{"operationId":"wallet_type_guide","summary":"Explains hot vs. cold (hardware/offline) wallets: definition, pros/cons, and common forms of each,","description":"Explains hot vs. cold (hardware/offline) wallets: definition, pros/cons, and common forms of each,\n    or both side by side. Use for \"hot wallet vs cold wallet\", \"what's a cold wallet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"wallet_type":{"default":"compare","description":"hot | cold | compare","title":"Wallet Type","type":"string"}},"title":"wallet_type_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/seed_phrase_security_practices":{"post":{"operationId":"seed_phrase_security_practices","summary":"Concrete do's and never's for protecting a seed phrase or private key: offline backups, never","description":"Concrete do's and never's for protecting a seed phrase or private key: offline backups, never\n    photographing or cloud-storing it, never typing it into a website or app, never sharing it with anyone.\n    Use for \"how do I keep my seed phrase safe\", \"is it OK to screenshot my seed phrase\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"seed_phrase_security_practicesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hardware_wallet_basics":{"post":{"operationId":"hardware_wallet_basics","summary":"What a hardware wallet is, how on-device transaction signing keeps keys offline, common forms (USB,","description":"What a hardware wallet is, how on-device transaction signing keeps keys offline, common forms (USB,\n    Bluetooth, fully air-gapped), and when it's worth using one. Use for \"what's a hardware wallet\", \"do I\n    need a hardware wallet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"hardware_wallet_basicsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/scam_pattern_lookup":{"post":{"operationId":"scam_pattern_lookup","summary":"Common wallet-drain scam patterns — fake airdrops, malicious approval/signature phishing, address","description":"Common wallet-drain scam patterns — fake airdrops, malicious approval/signature phishing, address\n    poisoning, fake wallet apps, fake customer support — each with red flags and how to avoid it. Use for \"is\n    this airdrop a scam\", \"what is address poisoning\", \"how do wallet drainers work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific scam pattern to look up (e.g. 'address poisoning', 'fake airdrop'); omit to list all.","title":"Pattern"}},"title":"scam_pattern_lookupArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/self_custody_readiness_check":{"post":{"operationId":"self_custody_readiness_check","summary":"Scores a person's OWN self-custody practices (true/false answers only — never a seed phrase or key","description":"Scores a person's OWN self-custody practices (true/false answers only — never a seed phrase or key\n    itself) into a weighted readiness score, risk band, and specific recommendations for anything not yet\n    followed. Use for \"am I following good wallet security practices\", \"how safe is my crypto setup\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"practices":{"additionalProperties":{"type":"boolean"},"description":"True/false answers for each practice (never a secret itself): seed_backed_up_offline, seed_never_photographed_or_cloud_stored, seed_never_entered_into_a_website_or_app, uses_hardware_wallet_for_significant_holdings, verifies_receiving_address_before_sending, reviews_token_approvals_periodically, never_shares_seed_with_anyone. Omitted keys count as false.","title":"Practices","type":"object"}},"required":["practices"],"title":"self_custody_readiness_checkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/custodial_vs_noncustodial_glossary":{"post":{"operationId":"custodial_vs_noncustodial_glossary","summary":"Definitions of custody-related terms: self-custody, custodial wallet, seed phrase, private key, public","description":"Definitions of custody-related terms: self-custody, custodial wallet, seed phrase, private key, public\n    address, hardware wallet, cold storage, hot wallet, token approval, address poisoning, multisig,\n    watch-only wallet, air-gapped signing, social engineering. Use for \"custodial vs non-custodial\", \"what's a\n    token approval\", \"what does multisig mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"custodial_vs_noncustodial_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}