战国时期，
楚国的最后一个国君是昌平君。
昌平君(前271年---前223年)，芈姓熊氏，战国末期楚王，公元前223年在位。其母亲为
秦国公主，外祖父为秦昭襄王。
《史记索隐》：“昌平君，楚之公子，（秦始皇）立以为（秦）相，后徙于郢城，项燕立为荆王，史失其名。”
他是战国末期楚国公子，受封为昌平君，仕于秦，为
秦庄襄王、秦王政之臣。前238年，与
吕不韦、昌文君受命平定
嫪毐之乱，任相国，迁郢陈以安抚楚民。
秦王政二十二年（前225年）反秦于郢陈，后作战不利，向江南败退。楚王负刍五年（前223年），秦军攻占楚都寿春，负刍被俘。昌平君被楚将项燕拥为楚王，在淮南一带继续反抗秦国。
王翦、蒙武率秦军来攻，昌平君兵败身亡，项燕自杀。楚国灭亡。
《史记·秦始皇本纪》记载，秦王政命令昌平君和昌文君发兵进攻嫪毐。（《史记·秦始皇本纪》载：四月，上宿雍。己酉，王冠，带剑。长信侯毐作乱而觉，矫王御玺及太后玺以发县卒及卫卒、官骑、戎翟君公、舍人，将欲攻蕲年宫为乱。
这是昌平君事迹最早的记载。司马贞《史记索隐》据此，解释道昌平君是楚国公子，在秦国当官，秦王立他为相。学者胡正明认为，昌平君此时并非为秦相，司马贞的理解是因为他对史记文字的句读有误。
《史记·秦始皇本纪》记载，前韩国首都新郑爆发反秦之乱，昌平君前往前楚国首都郢陈。
睡虎地秦简《编年纪》记载，韩王安死，昌平君居住在韩王的所在，有死者。
综合以上史料和历史背景，韩国于数年前为秦国所灭，而韩王安在前一年即秦王政二十年被转移到为秦国攻占的前楚国首都郢陈，而新郑反秦，为韩国灭亡的余波。秦王派昌平君前往郢陈稳定局势，也利用其楚国公子的特殊身份安抚当地楚人。
《史记·王翦列传》记载，当年秦国李信等将兵二十万讨伐楚国，朝东南方向深入楚国腹地，攻击平舆和寝丘，大胜楚军，兵锋指向楚国首都寿春。然而此时李信却转向西北去进攻后方的郢陈，攻破郢陈后继续西进，楚军追随秦军西进，大破李信军，秦军败走。楚军继续西进。
郢陈久为秦国所占，田余庆推测，郢陈叛秦事件，关键在当时居郢陈的秦国大臣昌平君身上。昌平君以其楚国公子身份在秦军后方反秦，郢陈附近原楚地的人民和原韩国的人民响应，虽然在李信回军后，郢陈一度被秦军夺回，但最终楚军击败了秦军。不仅收复了楚国前首都郢陈为中心的失地，更趁势西进深入至原韩国境内。秦王惊恐，不得不起用王翦。
《史记·秦始皇本纪》记载，王翦以六十万人伐楚国，取得郢陈以南至平舆，俘虏楚王负刍，秦王政到郢陈坐镇监督。楚国的将军项燕立昌平君为楚王，于淮南继续反秦。
睡虎地秦简《编年纪》记载，当年秦国征发大军攻楚国。四月，与昌平君一样，同为楚国公子而仕于秦的昌文君死。
《史记·六国年表》记载，秦王政二十三年，“王翦、蒙武击破楚军，杀其将项燕。”二十四年，“王翦、蒙武破楚，虏其王负刍。” 没有项燕立昌平君为王的记载。这与《史记·秦始皇本纪》不同，而和《史记·王翦列传》《楚世家》相同。
《项羽本纪》也说：“（项）梁父即楚将项燕，为秦将王翦所戮者也。”可见：1.项燕是被秦军所杀；2.楚王负刍是在项燕死的第二年被俘的；3.立昌平君者另有其人，或根本就没有这事，
司马迁记错了。
《史记·秦始皇本纪》记载，秦军最终击败楚军，昌平君死，项燕自杀。楚国灭亡。
而《史记·王翦列传》记载，王翦在决战中击败楚军，杀项燕，后俘虏楚王负刍。与《史记·秦始皇本纪》先楚王负刍被俘后项燕自杀的顺序有所不同。
年表基本根据田余庆的文章《说张楚-关于“亡秦必楚”问题的探讨》，见田余庆：
《秦汉魏晋史探微》，中华书局1993年。此处转引自陈苏镇、张帆编：
《中国古代史读本》，北京大学出版社2006年1月第1版，第175页。