Axie Marketplace GraphQL API

Overview

The Axie Infinity Marketplace schema is primarily used by the Axie Infinity Marketplace, but you can also query it to collect highly detailed Axie data. Use the examples provided on this page to learn how to structure your own Axie queries.

Endpoint

Axie Marketplace GraphQL endpoint

https://api-gateway.skymavis.com/graphql/marketplace

Prerequisites

• An API key for request authentication. To get an API key, create and set up an app in the Developer Console.
• Understanding of GraphQL basics.

Examples

This section contains some example GraphQL queries that you can run in the GraphQL Playground. Make sure to select the Axie Market schema from the list at the top of the page.

Get recently sold Axies

This query is used to retrieve detailed information about recently sold Axies.

Get recently sold Axies

{
  settledAuctions {
    axies {
      total
      results {
        name
        stage
        class
        breedCount
        image
        title
        genes
        newGenes
        battleInfo {
          banned
        }
        order {
          id
          currentPrice
          currentPriceUsd
        }
        parts {
          id
          name
          class
          type
          specialGenes
        }
        transferHistory {
          total
          results {
            from
            to
            txHash
            timestamp
            withPrice
            withPriceUsd
            fromProfile {
              name
            }
            toProfile {
              name
            }
          }
        }
      }
    }
  }
}

Get Axie's details

With this query, you can request detailed information about a specific Axie, including its sale history, current listing, and offers.

Get Axie's details

query GetAxieDetail($axieId: ID!) {
  axie(axieId: $axieId) {
    ...AxieDetail
  }
}

fragment AxieDetail on Axie {
  id
  image
  class
  chain
  name
  genes
  newGenes
  owner
  birthDate
  bodyShape
  class
  sireId
  sireClass
  matronId
  matronClass
  stage
  title
  breedCount
  level
  figure {
    atlas
    model
    image
  }
  parts {
    ...AxiePart
  }
  stats {
    ...AxieStats
  }
  order {
    ...OrderInfo
  }
  ...TokenAssetOffers
  ownerProfile {
    name
  }
  battleInfo {
    ...AxieBattleInfo
  }
  children {
    id
    name
    class
    image
    title
    stage
  }
  potentialPoints {
    beast
    aquatic
    plant
    bug
    bird
    reptile
    mech
    dawn
    dusk
  }
  equipmentInstances {
    ...EquipmentInstance
  }
}

fragment AxieBattleInfo on AxieBattleInfo {
  banned
  banUntil
  level
}

fragment AxiePart on AxiePart {
  id
  name
  class
  type
  specialGenes
  stage
  abilities {
    ...AxieCardAbility
  }
}

fragment AxieCardAbility on AxieCardAbility {
  id
  name
  attack
  defense
  energy
  description
  backgroundUrl
  effectIconUrl
}

fragment AxieStats on AxieStats {
  hp
  speed
  skill
  morale
}

fragment OrderInfo on Order {
  id
  maker
  kind
  assets {
    ...AssetInfo
  }
  expiredAt
  paymentToken
  startedAt
  basePrice
  endedAt
  endedPrice
  expectedState
  nonce
  marketFeePercentage
  signature
  hash
  duration
  timeLeft
  currentPrice
  suggestedPrice
  currentPriceUsd
}

fragment AssetInfo on Asset {
  erc
  address
  id
  quantity
  orderId
}

fragment EquipmentInstance on EquipmentInstance {
  id: tokenId
  tokenId
  owner
  equipmentId
  alias
  equipmentType
  slot
  name
  rarity
  collections
  equippedBy
}

fragment TokenAssetOffers on TokenAsset {
  ... on Axie {
    yourOffer {
      ...OfferInfo
    }
    highestOffer {
      ...OfferInfo
    }
    offers(from: 0, size: 10) {
      total
      data {
        ...OfferInfo
      }
    }
    numActiveOffers
  }
  ... on LandPlot {
    yourOffer {
      ...OfferInfo
    }
    highestOffer {
      ...OfferInfo
    }
    offers(from: 0, size: 10) {
      total
      data {
        ...OfferInfo
      }
    }
    numActiveOffers
  }
  ... on LandItem {
    yourOffer {
      ...OfferInfo
    }
    highestOffer {
      ...OfferInfo
    }
    offers(from: 0, size: 10) {
      total
      data {
        ...OfferInfo
      }
    }
    numActiveOffers
  }
  ... on EquipmentInstance {
    yourOffer {
      ...OfferInfo
    }
    highestOffer {
      ...OfferInfo
    }
    offers(from: 0, size: 10) {
      total
      data {
        ...OfferInfo
      }
    }
    numActiveOffers
  }
}

fragment OfferInfo on Order {
  ...ExcludedAssetsOffer
  status
  assets {
    ...ExcludedTokenAsset
    token {
      ...TokenAsset
    }
  }
}

fragment ExcludedAssetsOffer on Order {
  id
  maker
  makerProfile {
    ...Profile
  }
  kind
  expiredAt
  paymentToken
  startedAt
  basePrice
  endedAt
  endedPrice
  expectedState
  nonce
  marketFeePercentage
  signature
  hash
  duration
  timeLeft
  currentPrice
  suggestedPrice
  currentPriceUsd
}

fragment Profile on PublicProfile {
  accountId
  name
  addresses {
    ...Addresses
  }
}

fragment Addresses on NetAddresses {
  ethereum
  tomo
  loom
  ronin
}

fragment ExcludedTokenAsset on Asset {
  erc
  address
  id
  quantity
  orderId
}

fragment TokenAsset on TokenAsset {
  ... on Axie {
    id
    name
    class
    image
    stage
    owner
    newGenes
    title
    parts {
      id
      name
      class
      type
      specialGenes
      stage
    }
    ownerProfile {
      ...Profile
    }
  }
  ... on LandPlot {
    landType
    row
    col
    owner
    ownerProfile {
      ...Profile
    }
  }
  ... on LandItem {
    itemId
    name
    itemAlias
    tokenId
    landType
    itemId
    figureURL
    rarity
    owner
    tokenType
    ownerProfile {
      ...Profile
    }
  }
  ... on EquipmentInstance {
    equipmentId
    name
    rarity
    alias
    collections
    slot
    ownerProfile {
      ...Profile
    }
  }
}

Get marketplace data

This query returns sale stats for the last 24 hours, 7 days, or 30 days.

Get marketplace data

query GetOverviewToday {
  marketStats {
    last24Hours {
      ...OverviewFragment
    }
    last7Days {
      ...OverviewFragment
    }
    last30Days {
      ...OverviewFragment
    }
  }
}

fragment OverviewFragment on SettlementStats {
  count
  axieCount
  volume
  volumeUsd
}