{"openapi":"3.1.0","info":{"title":"Number Base Converter API","version":"1.0.0","description":"Convert integers between any numeral systems with exact big-integer math. Pass a number and a from/to base (radix 2 to 36, arbitrarily large, signed) and the convert endpoint returns the result and the decimal value; common 0x, 0b and 0o prefixes are accepted when they match the base, and whitespace or underscores in the input are ignored. The bases endpoint shows a single number across binary, octal, decimal, hexadecimal, base32 and base36 at once, together with its bit length, byte length and sign. Everything is computed locally with BigInt, so values of any size are exact and deterministic. Ideal for low-level and embedded debugging, networking and bit-twiddling work, teaching number systems, and anywhere you juggle hex, binary and decimal. A numeral-base converter — distinct from the text-encoding toolkit (encoding: base64/base32/hex of bytes), the Elixir/Erlang Hex package registry (hex) and number-to-words (numberwords). No upstream key, no cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/baseconvert-api","description":"oanor gateway"}],"tags":[{"name":"Base Converter"},{"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/bases":{"get":{"operationId":"get_v1_bases","tags":["Base Converter"],"summary":"A number across common bases","description":"","parameters":[{"name":"number","in":"query","required":true,"description":"The number","schema":{"type":"string"},"example":"255"},{"name":"from","in":"query","required":false,"description":"Source base 2-36 (default 10)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"input":"255","octal":"377","base32":"7v","base36":"73","binary":"11111111","decimal":"255","negative":false,"from_base":10,"bit_length":8,"byte_length":1,"hexadecimal":"ff"},"meta":{"timestamp":"2026-06-01T23:40:42.125Z","request_id":"5624005a-44b4-4f6d-989e-998fc0a4b84b"},"status":"ok","message":"Bases computed","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/convert":{"get":{"operationId":"get_v1_convert","tags":["Base Converter"],"summary":"Convert between bases","description":"","parameters":[{"name":"number","in":"query","required":true,"description":"The number (in the from base)","schema":{"type":"string"},"example":"ff"},{"name":"from","in":"query","required":false,"description":"Source base 2-36 (default 10)","schema":{"type":"string"},"example":"16"},{"name":"to","in":"query","required":false,"description":"Target base 2-36 (default 10)","schema":{"type":"string"},"example":"2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"input":"ff","result":"11111111","decimal":"255","to_base":2,"from_base":16},"meta":{"timestamp":"2026-06-01T23:40:42.222Z","request_id":"03f81cf4-6266-4e82-a831-cb4fec0db87f"},"status":"ok","message":"Number converted","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":"Radix range & digits","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Convert integers between numeral systems with exact big-integer math. /v1/convert?number=ff&from=16&to=2 converts a number from one base to another (radix 2–36, arbitrarily large, with sign and the decimal value); common prefixes 0x, 0b and 0o are accepted when they match the base, and whitespace/underscores in the input are ignored. /v1/bases?number=255 shows a number across binary, octal, decimal, hexadecimal, base32 and base36 at once, plus its bit length, byte length and sign. Everything is computed locally with BigInt, so values of any size are exact. Ideal for low-level debugging, embedded and networking work, teaching, and anywhere you juggle hex/binary/decimal. A numeral-base converter — distinct from the text-encoding toolkit (encoding: base64/base32/hex of bytes), the Elixir Hex package registry (hex) and number-to-words (numberwords). No key, no cache.","digits":"0123456789abcdefghijklmnopqrstuvwxyz","endpoints":["/v1/convert","/v1/bases","/v1/meta"],"radix_range":[2,36]},"meta":{"timestamp":"2026-06-01T23:40:42.321Z","request_id":"b9544d29-8a5e-42d1-8ffb-416d47f6676c"},"status":"ok","message":"Meta retrieved","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":2100,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":620,"monthly_call_quota":40500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2030,"monthly_call_quota":214000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5280,"monthly_call_quota":815000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/baseconvert-api"}