Axie GraphQL Docs

GetAxieBriefList

GetAxieBriefList

Fetches a list of existing Axies based on the given criterias.

Endpoint (Updated)

https://graphql-gateway.axieinfinity.com/graphql

Body

You can modify the query string to include fields that you want to be included or not. Refer to the GraphQL Schema below for a full overview.

{
"operationName": "GetAxieBriefList",
"variables": {
"from": 0,
"size": 24,
"sort": "PriceAsc",
"auctionType": "Sale",
"criteria": {}
},
"query": "query GetAxieBriefList($auctionType: AuctionType, $criteria: AxieSearchCriteria, $from: Int, $sort: SortBy, $size: Int, $owner: String) {\n axies(auctionType: $auctionType, criteria: $criteria, from: $from, sort: $sort, size: $size, owner: $owner) {\n total\n results {\n ...AxieBrief\n __typename\n }\n __typename\n }\n}\n\nfragment AxieBrief on Axie {\n id\n name\n stage\n class\n breedCount\n image\n title\n battleInfo {\n banned\n __typename\n }\n auction {\n currentPrice\n currentPriceUSD\n __typename\n }\n parts {\n id\n name\n class\n type\n specialGenes\n __typename\n }\n __typename\n}\n"
}
Full GraphQL Query Schema

 

query GetAxieBriefList(
$auctionType: AuctionType
$criteria: AxieSearchCriteria
$from: Int
$sort: SortBy
$size: Int
$owner: String
) {
axies(
auctionType: $auctionType
criteria: $criteria
from: $from
sort: $sort
size: $size
owner: $owner
) {
total
results {
...AxieBrief
__typename
}
__typename
}
}
fragment AxieBrief on Axie {
id
name
stage
class
breedCount
image
title
battleInfo {
banned
__typename
}
auction {
currentPrice
currentPriceUSD
__typename
}
parts {
id
name
class
type
specialGenes
__typename
}
__typename
}

Variables

Brief overview of the variable fields for this operation

VariableRequiredData Type
fromNoInteger
sizeNoInteger
sortNoString
auctionTypeNoString
ownerNoString
criteriaNoMap

Refer to the succeeding sections for more details about the variables and their valid values

From

Offset index of the results.

Any integer value. Signed or unsigned. Default is 0.

Size

Size of the result. The max size can vary based on the requesting source.

Any integer value. Signed or unsigned. Default is 20.

Sort

Sorting option of the results

PriceAsc, PriceDesc, IdAsc, IdDesc, Latest

AuctionType

Marketplace state of the Axie

All, Sale, NotForSale

Owner

Ronin address of the owner

Example: 0x2ebd51e17b56e9cea3317e8d13ab99ffb168427c

Criterias

Brief overview of the fields you can include in the criteria variable

VariableRequiredData Type
regionNo-
partsNoString Array
bodyShapesNo-
classesNoString Array
stagesNoInteger Array
numMysticNoInteger Array
purenessNoInteger Array
titleNo-
breedableNoBoolean
breedCountNoInteger Array
hpNoInteger Array
skillNoInteger Array
speedNoInteger Array
moraleNoInteger Array

Region

Parts

Array of the Axie Parts

Format: <part>-<partName>
Example: ["tail-yam", "horn-rose-bud"]

BodyShapes

Classes

Array of Axie classes

Beast, Aquatic, Plant, Bird, Bug, Reptile, Mech, Dawn, Dusk

Stages

Maturity of the Axie. Currently, only 1 (Egg) and 4 (Adult) will give results.

1 or 4

NumMystic

Array of Counts of Mystic Parts. Do note that this is an array so you can pass multiple mystic count vales.

1 to 6

Pureness

Array of Purity of the Axies. Do note that this is an array so you can pass multiple purity values.

1 to 6

Title

Breedable

Flag if an Axie is breedable or not. This does not work as expected so its best to ommit this on your queries.

true or false

Breed Count

Number of times an Axie has been used to breed

0 to 7

HP

HP stats of the Axie. Set the first element to the minimum value and the second to the maximum value.

[<min>, <max>]

Skill

Skill stats of the Axie. Set the first element to the minimum value and the second to the maximum value.

[<min>, <max>]

Speed

Speed stats of the Axie. Set the first element to the minimum value and the second to the maximum value.

[<min>, <max>]

Morale

Morale stats of the Axie. Set the first element to the minimum value and the second to the maximum value.

[<min>, <max>]

Edit this page on GitHub