The silent page awaits the waking dawn.
{
"code": 0,
"data": {
"tabs": [{
"key": "special",
"label": "",
"poolType": "E_CharacterGachaPoolType_Special"
},
{
"key": "rerun",
"label": "",
"poolType": "E_CharacterGachaPoolType_Rerun"
},
{
"key": "normal",
"label": "",
"poolType": "E_CharacterGachaPoolType_Standard"
}
],
"beginnerPullCount": 40
},
"msg": ""
}// seq_id=26&pool_type=E_CharacterGachaPoolType_Standard
{
"code": 0,
"data": {
"list": [
//...
{
"poolId": "standard",
"poolName": "基础寻访",
"charId": "chr_0019_karin",
"charName": "秋栗",
"rarity": 4,
"isFree": false,
"isNew": false,
"gachaTs": "1769073164712",
"seqId": "21"
}
],
"hasMore": false
},
"msg": ""
}
// pool_type=E_CharacterGachaPoolType_Beginner
{
"code": 0,
"data": {
"list": [
{
"poolId": "beginner",
"poolName": "启程寻访",
"charId": "chr_0022_bounda",
"charName": "萤石",
"rarity": 4,
"isFree": false,
"isNew": false,
"gachaTs": "1769072324787",
"seqId": "20" //该卡池最新的抽卡记录
},
// ...
],
"hasMore": true
},
"msg": ""
}{
"code": 0,
"data": [
{ "poolId": "weponbox_1_0_1", "poolName": "熔铸申领" },
{ "poolId": "weaponbox_constant_2", "poolName": "星声申领" }
// ...
],
"msg": ""
}{
"code": 0,
"data": {
"list": [
{
"poolId": "weponbox_1_0_1",
"poolName": "熔铸申领",
"weaponId": "wpn_funnel_0010",
"weaponName": "骑士精神",
"weaponType": "E_WeaponType_Wand",
"rarity": 6,
"isNew": true,
"gachaTs": "1769238381938",
"seqId": "47"
},
// ...
],
"hasMore": true
},
"msg": ""
}// 获取角色池记录
async function fetchCharacterRecords(token: string, serverId: string) {
const metaUrl = `https://ef-webview.hypergryph.com/api/record/char/meta?lang=zh-cn&token=${encodeURIComponent(token)}&server_id=${encodeURIComponent(serverId)}`;
const metaResponse = await fetch(metaUrl);
if (!metaResponse.ok) throw new Error("获取角色池元数据失败");
const { code, data: meta } = await metaResponse.json();
if (code !== 0 || !Array.isArray(meta?.tabs)) throw new Error("无效的角色池元数据");
const allRecords = [];
for (const pool of meta.tabs) {
if (typeof pool?.poolType !== "string" || !pool.poolType ||
(pool.poolId != null && typeof pool.poolId !== "string")) {
throw new Error("无效的角色子池");
}
let cursor: number | null = null;
let hasMore = true;
while (hasMore) {
const seqIdParam = cursor !== null ? `&seq_id=${cursor}` : "";
const poolIdParam = pool.poolId ? `&pool_id=${encodeURIComponent(pool.poolId)}` : "";
const url = `https://ef-webview.hypergryph.com/api/record/char?lang=zh-cn${seqIdParam}&pool_type=${encodeURIComponent(pool.poolType)}${poolIdParam}&token=${encodeURIComponent(token)}&server_id=${encodeURIComponent(serverId)}`;
const response = await fetch(url);
if (!response.ok) throw new Error("获取记录失败");
const { code, data } = await response.json();
if (code !== 0 || !Array.isArray(data?.list) ||
typeof data.hasMore !== "boolean" || (!data.list.length && data.hasMore)) {
throw new Error("官方接口返回错误或无效分页");
}
if (data.list.length > 0) {
allRecords.push(...data.list);
hasMore = data.hasMore;
if (hasMore) {
const seqIds = data.list.map((item: { seqId: string }) => Number(item.seqId));
if (seqIds.some((id: number) => !Number.isSafeInteger(id) || id <= 0)) {
throw new Error("序号超出安全整数范围或格式无效");
}
const nextCursor = Math.min(...seqIds);
if (cursor !== null && nextCursor >= cursor) throw new Error("分页游标未前进");
cursor = nextCursor;
await new Promise(resolve => setTimeout(resolve, 300));
}
} else {
hasMore = false;
}
}
}
return allRecords;
}
// 获取武器池记录
async function fetchWeaponRecords(token: string, serverId: string) {
const allRecords = [];
const poolListUrl = `https://ef-webview.hypergryph.com/api/record/weapon/pool?lang=zh-cn&token=${encodeURIComponent(token)}&server_id=${encodeURIComponent(serverId)}`;
const poolListResponse = await fetch(poolListUrl);
if (!poolListResponse.ok) throw new Error("获取武器池列表失败");
const { code, data: weaponPools } = await poolListResponse.json();
if (code !== 0 || !Array.isArray(weaponPools)) throw new Error("无效的武器池列表");
for (const pool of weaponPools) {
if (typeof pool.poolId !== "string" || !pool.poolId) throw new Error("武器池缺少标识");
let cursor: number | null = null;
let hasMore = true;
while (hasMore) {
const seqIdParam = cursor !== null ? `&seq_id=${cursor}` : "";
const url = `https://ef-webview.hypergryph.com/api/record/weapon?lang=zh-cn${seqIdParam}&pool_id=${encodeURIComponent(pool.poolId)}&token=${encodeURIComponent(token)}&server_id=${encodeURIComponent(serverId)}`;
const response = await fetch(url);
if (!response.ok) throw new Error("获取记录失败");
const { code, data } = await response.json();
if (code !== 0 || !Array.isArray(data?.list) ||
typeof data.hasMore !== "boolean" || (!data.list.length && data.hasMore)) {
throw new Error("官方接口返回错误或无效分页");
}
if (data.list.length > 0) {
allRecords.push(...data.list);
hasMore = data.hasMore;
if (hasMore) {
const seqIds = data.list.map((item: { seqId: string }) => Number(item.seqId));
if (seqIds.some((id: number) => !Number.isSafeInteger(id) || id <= 0)) {
throw new Error("序号超出安全整数范围或格式无效");
}
const nextCursor = Math.min(...seqIds);
if (cursor !== null && nextCursor >= cursor) throw new Error("分页游标未前进");
cursor = nextCursor;
await new Promise(resolve => setTimeout(resolve, 300));
}
} else {
hasMore = false;
}
}
}
return allRecords;
}
Update 2026-10-06: I originally wrote this post back when the servers first opened, and since then the official API's data structures — along with how the related data is fetched and processed — have changed quite a bit. I've now added the gift mechanic, rerun pools, and other details.
Arknights: Endfield launched publicly today. After playing for a while, I wanted to import my gacha data into a gacha analysis app. But since the game had just launched, I searched around and couldn't find any tool that exported gacha data, so I ended up building one myself. Below I'll walk through the main approach — hopefully it helps if you're trying to do the same thing.
What's in the URL
First, just like with other games, we can get a gacha record URL by capturing traffic with a packet sniffer, or with some other more convenient method.1:
Character Banners
For character banners, the two parameters we mainly care about are pool_type and seq_id:
pool_type is the banner's type code. You can use the API below to get the character banners shown on the gacha records page:
Returned data:
Right now it can only return one of the following banner values:
Unlike in Genshin Impact, Wuthering Waves, and other games, Endfield's gacha record URLs usually include the seq_id parameter.
By comparing the records from the two different banners above, we can spot some features of the seq_id parameter:
From these features we can tell that in the in-game gacha record view, paging from the first page onward (from newest to oldest) is the process of the seq_id parameter in the record URL decreasing.
The gacha records returned by the URL also include a hasMore parameter. It tells you whether there's still data below the smallest seqId in the current response — in other words, whether you can still flip to the next page on the gacha screen.
Also, Endfield's banners have a gift mechanic. Once you reach 60 cumulative pulls on the current Limited Search, you get a free Search Intelligence Book, and the API adds a reward record with kind: "gift_intel_book". You need to filter these out when processing gacha data, otherwise the number of records the API returns won't match your pull count.
Weapon Banners
Similar to character banners, weapon banners can be fetched through two APIs:
Getting the Weapon Banner List
First use the URL below to get the list of weapon banners the user has pull records for:
Returned data structure:
We can see weapon banners come in several types:
One funny thing to note: the weapon prefix for limited weapon banners is written as wepon
Getting Weapon Gacha Records
The URL format for a specific weapon banner's gacha records differs a little from character banners: instead of the pool_id parameter, weapon banner record URLs use the pool_type parameter:
Here's the structure of the data it returns:
The fields in weapon records differ slightly from character records:
The seq_id behavior for weapon banners is the same as for character banners — all weapon sub-banners share a single seqId sequence.
At this point we have basically figured out the logic behind Arknights: Endfield's gacha record URLs.
The Main Approach
Based on the above, we can conceive of a method to fetch all currently queryable records from a single valid Endfield gacha record URL:
Character Banners
Weapon Banners
Code Implementation
And with that, we've implemented fetching all queryable records for every banner in Arknights: Endfield.