update API to return `global` directly

No more function call required
Readme++