{"openapi":"3.1.0","info":{"title":"MAC Addresses","version":"0.1.0","description":"MAC / EUI-48 & EUI-64 address utilities — parse and normalize any notation, inspect unicast/multicast and universal/local properties, reformat, derive the EUI-64 / IPv6 link-local identifier, and generate random addresses.","x-guidance":"MAC / EUI-48 & EUI-64 address utilities — parse and normalize any notation, inspect unicast/multicast and universal/local properties, reformat, derive the EUI-64 / IPv6 link-local identifier, and generate random addresses. Each operation is an HTTP POST to its /v1/<operation> path with a JSON request body (see each operation's requestBody schema) and returns a JSON response. Endpoints are paid per successful call via x402 or MPP (USDC on Base); an unpaid request returns 402 with payment metadata in the WWW-Authenticate header.","contact":{"email":"hello@openverbs.com"}},"x-discovery":{"ownershipProofs":["0xb1401a71756f51464a9962db12f1eb3e9522490cd20010b06d00cf7b7770acfd5f79721f9dfdf2643f8cecd29af3bde9ec133941a386042b32d9886053a70de61b","0xc1c1f11793e18a00fcb7072421f26e89fb75b6aa517fa84370564991f4b10efa024f6f57e4e67eefd20cf46cc01fc5a62d793fa8fbcda04f26c946a3433d73f91b","0x676b474af0ef9ed4809b5d12d2e789b36e52d56215b21f601d71f76620e36ec630347116a7b2b349a3c3681e5db0fbfa76c4169a676b6d6f27864d0e5017284a1c","0xc2ab96522515ed9e9bc4f1a241b774bd48df42e951ddbf7f6aa8fc76f5a96a20421703e1ec402ce7eb1e4eabea3b6e4e4129cf39d56ea91cf4fcf38561fc94fc1c"]},"servers":[{"url":"https://macaddress.openverbs.com"}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"}}}}}}}}},"/v1/parse":{"post":{"summary":"Parse & normalize a MAC address","description":"Parse a MAC / EUI-48 or EUI-64 address from any common notation (colon, hyphen, Cisco dot, or bare hex) and return it in every canonical form plus its integer value. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["parse mac address","normalize mac address","mac address parser","eui-48 lookup","convert mac notation","mac address canonical form"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1,"maxLength":64,"description":"MAC address in colon, hyphen, dot or bare notation."}},"required":["address"],"additionalProperties":false},"example":{"address":"00:1A:2B:3C:4D:5E"}}}},"responses":{"200":{"description":"`{ eui, hex, bytes, colon, hyphen, dot, integer }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ eui, hex, bytes, colon, hyphen, dot, integer }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Parse a MAC / EUI-48 or EUI-64 address from any common notation (colon, hyphen, Cisco dot, or bare hex) and return it in every canonical form plus its integer value.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Parse a MAC / EUI-48 or EUI-64 address from any common notation (colon, hyphen, Cisco dot, or bare hex) and return it in every canonical form plus its integer value.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Parse a MAC / EUI-48 or EUI-64 address from any common notation (colon, hyphen, Cisco dot, or bare hex) and return it in every canonical form plus its integer value.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/info":{"post":{"summary":"Inspect address properties","description":"Report the properties of a MAC address encoded in its first octet: unicast vs multicast (I/G bit), universal vs locally-administered (U/L bit), the broadcast address, and — for EUI-48 — the OUI and NIC portions. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["mac address lookup","inspect mac address","oui lookup api","mac address properties","detect multicast mac","locally administered mac"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1,"maxLength":64,"description":"MAC address in colon, hyphen, dot or bare notation."}},"required":["address"],"additionalProperties":false},"example":{"address":"00:1A:2B:3C:4D:5E"}}}},"responses":{"200":{"description":"`{ eui, unicast, multicast, universal, local, broadcast, oui, nic }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ eui, unicast, multicast, universal, local, broadcast, oui, nic }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Report the properties of a MAC address encoded in its first octet: unicast vs multicast (I/G bit), universal vs locally-administered (U/L bit), the broadcast address, and — for EUI-48 — the OUI and NIC portions.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Report the properties of a MAC address encoded in its first octet: unicast vs multicast (I/G bit), universal vs locally-administered (U/L bit), the broadcast address, and — for EUI-48 — the OUI and NIC portions.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Report the properties of a MAC address encoded in its first octet: unicast vs multicast (I/G bit), universal vs locally-administered (U/L bit), the broadcast address, and — for EUI-48 — the OUI and NIC portions.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/format":{"post":{"summary":"Reformat a MAC address","description":"Reformat a MAC address into the requested notation (colon, hyphen, Cisco dot or bare) and case (lower default or upper). Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["format mac address","mac notation converter","convert mac to colon","cisco mac format","uppercase mac address","reformat eui address"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1,"maxLength":64,"description":"MAC address in colon, hyphen, dot or bare notation."},"notation":{"type":"string","enum":["colon","hyphen","dot","bare"],"description":"Output notation. Default colon."},"case":{"type":"string","enum":["upper","lower"],"description":"Output case. Default lower."}},"required":["address"],"additionalProperties":false},"example":{"address":"00:1A:2B:3C:4D:5E","notation":"colon","case":"upper"}}}},"responses":{"200":{"description":"`{ formatted }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ formatted }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Reformat a MAC address into the requested notation (colon, hyphen, Cisco dot or bare) and case (lower default or upper).","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Reformat a MAC address into the requested notation (colon, hyphen, Cisco dot or bare) and case (lower default or upper).","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Reformat a MAC address into the requested notation (colon, hyphen, Cisco dot or bare) and case (lower default or upper).","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/to-eui64":{"post":{"summary":"EUI-48 → EUI-64 / IPv6 IID","description":"Derive the modified EUI-64 interface identifier from a 48-bit MAC (insert FFFE, flip the U/L bit) and the resulting IPv6 link-local address (fe80::/64). Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["mac to eui64","derive ipv6 interface id","eui-48 to eui-64","ipv6 link local from mac","modified eui64 converter","mac address iid"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1,"maxLength":64,"description":"MAC address in colon, hyphen, dot or bare notation."}},"required":["address"],"additionalProperties":false},"example":{"address":"00:1A:2B:3C:4D:5E"}}}},"responses":{"200":{"description":"`{ eui64, interfaceId, linkLocal }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ eui64, interfaceId, linkLocal }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Derive the modified EUI-64 interface identifier from a 48-bit MAC (insert FFFE, flip the U/L bit) and the resulting IPv6 link-local address (fe80::/64).","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Derive the modified EUI-64 interface identifier from a 48-bit MAC (insert FFFE, flip the U/L bit) and the resulting IPv6 link-local address (fe80::/64).","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Derive the modified EUI-64 interface identifier from a 48-bit MAC (insert FFFE, flip the U/L bit) and the resulting IPv6 link-local address (fe80::/64).","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/generate":{"post":{"summary":"Generate a random MAC address","description":"Generate a random EUI-48 MAC address. By default it is locally-administered and unicast (safe for testing); set `local:false` for a universal-bit address or `multicast:true` for a group address. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["generate mac address","random mac address","test mac address generator","locally administered mac generator","multicast mac generator","fake eui-48 address"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"local":{"type":"boolean","description":"Set the locally-administered (U/L) bit. Default true."},"multicast":{"type":"boolean","description":"Set the multicast (I/G) bit. Default false."}},"additionalProperties":false}}}},"responses":{"200":{"description":"`{ address, local, multicast }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ address, local, multicast }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Generate a random EUI-48 MAC address. By default it is locally-administered and unicast (safe for testing); set `local:false` for a universal-bit address or `multicast:true` for a group address.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Generate a random EUI-48 MAC address. By default it is locally-administered and unicast (safe for testing); set `local:false` for a universal-bit address or `multicast:true` for a group address.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Generate a random EUI-48 MAC address. By default it is locally-administered and unicast (safe for testing); set `local:false` for a universal-bit address or `multicast:true` for a group address.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}}},"x-service-info":{"categories":["network"],"docs":{"homepage":"https://macaddress.openverbs.com","apiReference":"https://macaddress.openverbs.com/openapi.json"}}}