Number Base Conversion

Convert integers between binary (base 2), octal (base 8), decimal (base 10), and hexadecimal (base 16).

Get API Key

Overview

Use Cases

Developer tools and calculators
Converting memory addresses or CPU flags between hex and binary
Teaching or learning number systems
Debugging low-level protocol data

Features

Supports binary, octal, decimal, and hexadecimal

Accepts optional base prefixes (0x, 0b, 0o)

Supports negative integers

Fast, in-memory only — no database required

API Endpoints

Convert Base

Convert an integer from one number base to another.

GET

https://requiems.xyz/v1/technology/base

Parameters

Name	Type	Required	Description
from	`integer`	Required	Source base (2, 8, 10, or 16)
to	`integer`	Required	Target base (2, 8, 10, or 16)
value	`string`	Required	The number as a string. Accepts optional prefixes: 0x (hex), 0b (binary), 0o (octal).

Try it out

Live Demo

Request

from * (integer)

Source base (2, 8, 10, or 16)

to * (integer)

Target base (2, 8, 10, or 16)

value * (string)

The number as a string. Accepts optional prefixes: 0x (hex), 0b (binary), 0o (octal).

Response Fields

Field	Type	Description
input	`string`	The original value as provided in the request
from	`integer`	The source base
to	`integer`	The target base
result	`string`	The converted value in the target base

Code Examples

# Decimal to hex
curl "https://requiems.xyz/v1/technology/base?from=10&to=16&value=255" \
  -H "requiems-api-key: YOUR_API_KEY"

# Hex to binary (using 0x prefix)
curl "https://requiems.xyz/v1/technology/base?from=16&to=2&value=0xff" \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://requiems.xyz/v1/technology/base"
headers = {"requiems-api-key": "YOUR_API_KEY"}
params = {"from": 10, "to": 16, "value": "255"}

response = requests.get(url, params=params, headers=headers)
print(response.json()["data"]["result"])  # ff

const params = new URLSearchParams({ from: 10, to: 16, value: '255' });
const response = await fetch(
  `https://requiems.xyz/v1/technology/base?${params}`,
  { headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);

const { data } = await response.json();
console.log(data.result); // ff

require 'net/http'
require 'json'

uri = URI('https://requiems.xyz/v1/technology/base')
uri.query = URI.encode_www_form(from: 10, to: 16, value: '255')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)['data']['result']  # ff

Error Responses

bad_request

A required parameter is missing, the base is not one of 2/8/10/16, or value is not valid for the given base.

Batch Convert Base

Convert up to 50 numbers between bases in a single request. Results are returned in input order. Per-item errors are reported inline.

POST

https://requiems.xyz/v1/technology/base/batch

Parameters

Name	Type	Required	Description
items	`array<object>`	Required	List of conversion requests (1–50 items).
items[].from	`integer`	Required	Source base (2, 8, 10, or 16).
items[].to	`integer`	Required	Target base (2, 8, 10, or 16).
items[].value	`string`	Required	The number as a string. Accepts optional prefixes: 0x (hex), 0b (binary), 0o (octal).

Try it out

Live Demo

Request

items * (array<object>)

List of conversion requests (1–50 items).

items[].from * (integer)

Source base (2, 8, 10, or 16).

items[].to * (integer)

Target base (2, 8, 10, or 16).

items[].value * (string)

The number as a string. Accepts optional prefixes: 0x (hex), 0b (binary), 0o (octal).

Response Fields

Field	Type	Description
results	`array<object>`	Per-item results in input order.
results[].from	`integer`	The source base used for conversion.
results[].to	`integer`	The target base used for conversion.
results[].input	`string`	The original value as provided in the request.
results[].result	`string`	The converted value in the target base (omitted on error).
results[].error	`string`	Error message if this item failed (omitted on success).
total	`integer`	Total number of items processed.

Code Examples

curl -X POST https://requiems.xyz/v1/technology/base/batch \
  -H "requiems-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"from": 10, "to": 16, "value": "255"}, {"from": 2, "to": 10, "value": "1111"}]}'

import requests

url = "https://requiems.xyz/v1/technology/base/batch"
headers = {
    "requiems-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "items": [
        {"from": 10, "to": 16, "value": "255"},
        {"from": 2,  "to": 10, "value": "1111"}
    ]
}

response = requests.post(url, headers=headers, json=payload)
for item in response.json()["data"]["results"]:
    print(item.get("result") or item.get("error"))

const response = await fetch('https://requiems.xyz/v1/technology/base/batch', {
  method: 'POST',
  headers: {
    'requiems-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    items: [
      { from: 10, to: 16, value: '255' },
      { from: 2,  to: 10, value: '1111' }
    ]
  })
});

const { data } = await response.json();
data.results.forEach(item => console.log(item.result ?? item.error));

require 'net/http'
require 'json'

uri = URI('https://requiems.xyz/v1/technology/base/batch')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
  items: [
    { from: 10, to: 16, value: '255' },
    { from: 2,  to: 10, value: '1111' }
  ]
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)['data']
data['results'].each { |item| puts item['result'] || item['error'] }

Error Responses

validation_failed

The items array is missing, empty, or exceeds 50 items.

bad_request

The request body is missing or malformed.

No results found

No results found

Number Base Conversion

Overview

Use Cases

Features

API Endpoints

Convert Base

Parameters

Try it out

Request

Response

Error

Response Fields

Code Examples

Error Responses

Batch Convert Base

Parameters

Try it out

Request

Response

Error

Response Fields

Code Examples

Error Responses

Frequently Asked Questions