{"openapi":"3.1.0","info":{"title":"BIP39 Mnemonic API","version":"1.0.0","description":"Work with BIP39 mnemonic seed phrases — the 12-to-24-word recovery phrases used by crypto wallets. Generate a phrase at a chosen strength (128–256 bits) in any of 9 wordlist languages, validate a phrase, convert between a phrase and its raw entropy in both directions, and derive the 512-bit BIP39 seed (with an optional passphrase) used for HD-wallet key derivation. Pure local computation — no key, no third-party service. Note: intended for development, testing and education; generate seeds for real funds offline / client-side, never trust a remote API with production keys. Live, nothing stored. 7 endpoints. Distinct from market-data, password and 2FA tools.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bip39-api","description":"oanor gateway"}],"tags":[{"name":"Mnemonic"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/from-entropy":{"get":{"operationId":"get_v1_from_entropy","tags":["Mnemonic"],"summary":"Entropy to mnemonic","description":"","parameters":[{"name":"entropy","in":"query","required":true,"description":"Hex entropy (16-32 bytes)","schema":{"type":"string"},"example":"00000000000000000000000000000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"entropy":"00000000000000000000000000000000","language":"english","mnemonic":"abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"},"meta":{"timestamp":"2026-06-02T16:51:52.955Z","request_id":"a033fb51-4501-4a5c-aaec-e961fba44fb9"},"status":"ok","message":"Entropy to mnemonic","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/generate":{"get":{"operationId":"get_v1_generate","tags":["Mnemonic"],"summary":"Generate a mnemonic","description":"","parameters":[{"name":"strength","in":"query","required":false,"description":"128|160|192|224|256 (default 128)","schema":{"type":"string"},"example":"128"},{"name":"language","in":"query","required":false,"description":"english|spanish|french|… (default english)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"For development/testing. Generate production wallet seeds offline/client-side.","entropy":"252f518239d9a8fd0104cf714503b485","language":"english","mnemonic":"cement kind gauge inhale once leader advice okay image chimney unfold anxiety","strength":128,"word_count":12},"meta":{"timestamp":"2026-06-02T16:51:53.070Z","request_id":"714b3720-3c0c-4103-95e2-551ab5c48d1d"},"status":"ok","message":"Generate a mnemonic","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/to-entropy":{"get":{"operationId":"get_v1_to_entropy","tags":["Mnemonic"],"summary":"Mnemonic to entropy","description":"","parameters":[{"name":"mnemonic","in":"query","required":true,"description":"Mnemonic phrase","schema":{"type":"string"},"example":"abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"entropy":"00000000000000000000000000000000"},"meta":{"timestamp":"2026-06-02T16:51:53.171Z","request_id":"8d2b63f1-cce1-4cfb-8b6d-0c2123a5c74d"},"status":"ok","message":"Mnemonic to entropy","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/to-seed":{"get":{"operationId":"get_v1_to_seed","tags":["Mnemonic"],"summary":"Mnemonic to BIP39 seed","description":"","parameters":[{"name":"mnemonic","in":"query","required":true,"description":"Mnemonic phrase","schema":{"type":"string"},"example":"abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"},{"name":"passphrase","in":"query","required":false,"description":"Optional passphrase","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"seed":"5eb00bbddcf069084889a8ab9155568165f5c453ccb85e70811aaed6f6da5fc19a5ac40b389cd370d086206dec8aa6c43daea6690f20ad3d8d48b2d2ce9e38e4","passphrase_used":false,"seed_length_bytes":64},"meta":{"timestamp":"2026-06-02T16:51:53.341Z","request_id":"fd028976-ebfc-4005-9ef7-a96401c1d98d"},"status":"ok","message":"Mnemonic to BIP39 seed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/validate":{"get":{"operationId":"get_v1_validate","tags":["Mnemonic"],"summary":"Validate a mnemonic","description":"","parameters":[{"name":"mnemonic","in":"query","required":true,"description":"Mnemonic phrase","schema":{"type":"string"},"example":"abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"},{"name":"language","in":"query","required":false,"description":"Wordlist language","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"valid":true,"language":"english","word_count":12},"meta":{"timestamp":"2026-06-02T16:51:53.447Z","request_id":"cecf11fd-4edb-452b-b920-d903a9624943"},"status":"ok","message":"Validate a mnemonic","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/languages":{"get":{"operationId":"get_v1_languages","tags":["Reference"],"summary":"Supported wordlists","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"languages":["czech","chinese_simplified","chinese_traditional","korean","french","italian","spanish","japanese","portuguese","english"]},"meta":{"timestamp":"2026-06-02T16:51:53.552Z","request_id":"6f1b55f6-1ee4-4944-b017-a73ff953a124"},"status":"ok","message":"Supported wordlists","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"auth":"none upstream; this gateway requires x-api-key","name":"BIP39 Mnemonic API","note":"BIP39 mnemonic seed phrases. /v1/generate?strength=128..256&language=english (12-24 words), /v1/validate, /v1/to-entropy, /v1/from-entropy?entropy=hex, /v1/to-seed?mnemonic=&passphrase=, /v1/languages. For development, testing and education — generate production wallet seeds offline/client-side, never trust a remote API with real funds. Instant, nothing stored.","source":"Local BIP39 (bip39) — no key, no upstream","endpoints":7},"meta":{"timestamp":"2026-06-02T16:51:53.633Z","request_id":"a1c8257f-b8c1-4865-96ed-63a26e1a9003"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1200,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":380,"monthly_call_quota":13000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2340,"monthly_call_quota":152000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5940,"monthly_call_quota":780000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bip39-api"}