add API holding, initial code (untested)
elaborate in README