search_lands
Find available land plots on the Axie Infinity marketplace using filters for owner, land type, auction status, and sorting options.
Instructions
Search for land plots on the Axie Infinity marketplace with optional filters.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | No | Filter by owner Ronin address (ronin:xxxx or 0x...). | |
| landType | No | Filter by land type. | |
| from | No | Pagination offset. Default 0. | |
| size | No | Number of results to return. Default 10. | |
| sort | No | Sort order for results. | |
| auctionType | No | Filter by listing status. |
Implementation Reference
- src/index.ts:698-730 (handler)The handler function for the 'search_lands' tool, which parses input arguments, constructs GraphQL variables, and queries the client.
case "search_lands": { const schema = z.object({ owner: RoninAddress.optional(), landType: LandTypeEnum.optional(), from: z.coerce.number().int().min(0).default(0), size: z.coerce.number().int().min(1).max(100).default(10), sort: SortByEnum.optional(), auctionType: AuctionTypeEnum.optional(), }); const parsed = schema.parse(args ?? {}); const variables: Record<string, unknown> = { from: parsed.from, size: parsed.size, }; if (parsed.auctionType) variables.auctionType = parsed.auctionType; if (parsed.sort) variables.sort = parsed.sort; if (parsed.owner) { variables.owner = { address: parsed.owner, ownerships: ["Owned"], }; } if (parsed.landType) { variables.criteria = { landType: [parsed.landType] }; } const data = await client.query<{ lands: unknown }>( queries.GET_LANDS, variables ); return jsonContent(data.lands); } - src/index.ts:303-320 (registration)Tool definition/registration for 'search_lands'.
name: "search_lands", description: "Search for land plots on the Axie Infinity marketplace with optional filters.", inputSchema: { type: "object", properties: { owner: { type: "string", description: "Filter by owner Ronin address (ronin:xxxx or 0x...).", }, landType: { type: "string", enum: ["Savannah", "Forest", "Arctic", "Mystic", "Genesis", "LunaLanding"], description: "Filter by land type.", }, from: { type: "number", description: "Pagination offset. Default 0.",