All notable changes to the Sorare GraphQL API will be documented in this file. We reserve the right to remove deprecated fields after they've been deprecated for more than 1 month.
The format is based on Keep a Changelog.
A new subscription has been introduced. It gives access to all cards updates (not just football). Updates can be filtered by sport.
✔ Field 'anyCardWasUpdated' was added to object type 'Subscription' ✔ Field 'Subscription.aCardWasUpdated' is deprecated ✔ Field 'Subscription.aCardWasUpdated' has deprecation reason 'Use any_card_was_updated instead'
Many fields that had been deprecated for more than 3 months have been removed. Some new deprecation have also been introduced.
⚠ Field 'openedSo5Lineup' (deprecated) was removed from object type 'BaseballCard' ⚠ Field 'openedSo5Lineup' (deprecated) was removed from object type 'Card' ⚠ Field 'card' (deprecated) was removed from object type 'CardCollectionCard' ⚠ Field 'card' (deprecated) was removed from object type 'CardCollectionNotification' ⚠ Field 'card' (deprecated) was removed from object type 'CardNotification' ⚠ Field 'openedSo5Lineup' (deprecated) was removed from object type 'CardSubscription' ⚠ Field 'autoPick' (deprecated) was removed from object type 'CommonDraftCampaign' ⚠ Field 'baseball' (deprecated) was removed from object type 'Counts' ⚠ Field 'football' (deprecated) was removed from object type 'Counts' ⚠ Field 'nba' (deprecated) was removed from object type 'Counts' ⚠ Field 'tokenFootball' (deprecated) was removed from object type 'Counts' ⚠ Field 'card' (deprecated) was removed from object type 'createCardWithdrawalPayload' ⚠ Field 'subscriptionStats' (deprecated) was removed from object type 'createSubscriptionPayload' ⚠ Field 'cardCounts' (deprecated) was removed from object type 'CurrentUser' ⚠ Field 'onboardingStatus' (deprecated) was removed from object type 'CurrentUser' ⚠ Field 'paginatedCards' (deprecated) was removed from object type 'CurrentUser' ⚠ Field 'topRecommendations' (deprecated) was removed from object type 'CurrentUser' ⚠ Field 'tokens' (deprecated) was removed from object type 'Deck' ⚠ Field 'subscriptionStats' (deprecated) was removed from object type 'deleteSubscriptionPayload' ⚠ Field 'postChallengeResultVideo' (deprecated) was removed from object type 'FootballRivalsChallenge' ⚠ Field 'socialPictureUrls' (deprecated) was removed from object type 'FootballRivalsChallenge' ⚠ Field 'friendlyChallengerSections' (deprecated) was removed from object type 'FootballRivalsConfig' ⚠ Field 'unlockedArenaTicketsDrop' (deprecated) was removed from object type 'FootballRivalsConfig' ⚠ Field 'eloDelta' (deprecated) was removed from object type 'FootballRivalsContestant' ⚠ Field 'aggregatedUnreadArenaStories' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'aggregatedUnreadArenaStoriesResults' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'completedOrReadyArenaStreakTask' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'division' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'eloGroup' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'eloScore' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'highestEloScore' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'highestScore' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'mostLossesAgainstOpponent' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'mostWinsAgainstOpponent' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'myUpcomingReceivedInvitesCount' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'nextArenaRequestAvailableAt' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'nextArenaTicketClaimableAt' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'nextUnreadArenaPostGameStories' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'nextUnreadArenaPostGameStory' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'nextUnreadBotFriendlyPostGameStory' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'readyArenaStreakTask' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'readyTask' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'records' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'remainingBetaInvites' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'unreadArenaPostGameStoriesCount' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'unreadArenaStories' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'unreadArenaStoriesCount' (deprecated) was removed from object type 'FootballRivalsCurrentManager' ⚠ Field 'division' (deprecated) was removed from object type 'FootballRivalsDivisionLeaderboardConfig' ⚠ Field 'managerCountConditionToRevealLeaderboard' (deprecated) was removed from object type 'FootballRivalsDivisionLeaderboardConfig' ⚠ Field 'probabilisticBundleConfig' (deprecated) was removed from object type 'FootballRivalsDivisionLeaderboardRankingReward' ⚠ Field 'lastFifteenAverageScore' (deprecated) was removed from object type 'FootballRivalsDraftableCard' ⚠ Field 'lastFifteenAverageScore' (deprecated) was removed from object type 'FootballRivalsDraftablePlayer' ⚠ Field 'eloDelta' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myEloDelta' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myFriendlyChallengesPaginated' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myInvite' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myInviteSocialPictureUrls' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myInvites' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myPostGameStoryState' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myPotentialEloDeltaLoss' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myPotentialEloDeltaWin' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'myReceivedInvites' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'mySentInvites' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'mySuggestedManagers' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'recommendedChallengers' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'recommendedChallengersForNewUsers' (deprecated) was removed from object type 'FootballRivalsGame' ⚠ Field 'completedOrReadyArenaStreakTask' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'division' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'eloGroup' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'eloScore' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'highestEloScore' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'highestScore' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'mostLossesAgainstOpponent' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'mostWinsAgainstOpponent' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'myUpcomingReceivedInvitesCount' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'readyArenaStreakTask' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'readyTask' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'records' (deprecated) was removed from object type 'FootballRivalsManager' ⚠ Field 'id' (deprecated) was removed from object type 'FootballRivalsRankingsPaginated' ⚠ Field 'myOnboardingFeaturedGames' (deprecated) was removed from object type 'FootballRivalsRoot' ⚠ Field 'myOngoingAndRecentGames' (deprecated) was removed from object type 'FootballRivalsRoot' ⚠ Field 'showBeta' (deprecated) was removed from object type 'FootballRivalsRoot' ⚠ Field 'cardCollection' (deprecated) was removed from object type 'FootballRoot' ⚠ Field 'customDeck' (deprecated) was removed from object type 'FootballRoot' ⚠ Field 'shopItems' (deprecated) was removed from object type 'FootballRoot' ⚠ Field 'so5' (deprecated) was removed from object type 'FootballRoot' ⚠ Field 'userCardCollection' (deprecated) was removed from object type 'FootballRoot' ⚠ Field 'myIncompleteCardCollections' (deprecated) was removed from object type 'ForYouRoot' ⚠ Field 'status' (deprecated) was removed from object type 'Game' ⚠ Field 'baseballGame' (deprecated) was removed from object type 'GameOfBaseball' ⚠ Field 'autoPickDraft' (deprecated) was removed from object type 'Mutation' ⚠ Field 'claimCardDrop' (deprecated) was removed from object type 'Mutation' ⚠ Field 'completeOnboardingTask' (deprecated) was removed from object type 'Mutation' ⚠ Field 'declareFootballManagerTask' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsArenaTicketClaim' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsGameMarkArenaStoriesAsRead' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsGameMarkPostGameStoriesAsRead' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsGameMarkPostGameStoryAsRead' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsInviteAccept' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsInviteAcceptCode' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsInviteCreate' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsInviteReject' (deprecated) was removed from object type 'Mutation' ⚠ Field 'footballRivalsInvitesAccept' (deprecated) was removed from object type 'Mutation' ⚠ Field 'resumeOnboarding' (deprecated) was removed from object type 'Mutation' ⚠ Field 'skipOnboarding' (deprecated) was removed from object type 'Mutation' ⚠ Field 'startOnboarding' (deprecated) was removed from object type 'Mutation' ⚠ Field 'openedSo5Lineup' (deprecated) was removed from object type 'NBACard' ⚠ Field 'amount' (deprecated) was removed from object type 'PendingDeposit' ⚠ Field 'amountInFiat' (deprecated) was removed from object type 'PendingDeposit' ⚠ Field 'status' (deprecated) was removed from object type 'Player' ⚠ Field 'player' (deprecated) was removed from object type 'PlayerWithSupply' ⚠ Field 'card' (deprecated) was removed from object type 'ProbabilisticBundleSlotCardItem' ⚠ Field 'allCards' (deprecated) was removed from object type 'Query' ⚠ Field 'card' (deprecated) was removed from object type 'Query' ⚠ Field 'cardByAssetId' (deprecated) was removed from object type 'Query' ⚠ Field 'cardByBlockchainId' (deprecated) was removed from object type 'Query' ⚠ Field 'cards' (deprecated) was removed from object type 'Query' ⚠ Field 'club' (deprecated) was removed from object type 'Query' ⚠ Field 'clubs' (deprecated) was removed from object type 'Query' ⚠ Field 'clubsReady' (deprecated) was removed from object type 'Query' ⚠ Field 'competition' (deprecated) was removed from object type 'Query' ⚠ Field 'customDeck' (deprecated) was removed from object type 'Query' ⚠ Field 'featuredSo5Fixtures' (deprecated) was removed from object type 'Query' ⚠ Field 'game' (deprecated) was removed from object type 'Query' ⚠ Field 'leaguesOpenForGameStats' (deprecated) was removed from object type 'Query' ⚠ Field 'player' (deprecated) was removed from object type 'Query' ⚠ Field 'playerGameScore' (deprecated) was removed from object type 'Query' ⚠ Field 'players' (deprecated) was removed from object type 'Query' ⚠ Field 'so5Appearance' (deprecated) was removed from object type 'Query' ⚠ Field 'so5Fixture' (deprecated) was removed from object type 'Query' ⚠ Field 'so5Leaderboard' (deprecated) was removed from object type 'Query' ⚠ Field 'so5LeaderboardGroup' (deprecated) was removed from object type 'Query' ⚠ Field 'so5League' (deprecated) was removed from object type 'Query' ⚠ Field 'so5Lineup' (deprecated) was removed from object type 'Query' ⚠ Field 'so5Ranking' (deprecated) was removed from object type 'Query' ⚠ Field 'so5Reward' (deprecated) was removed from object type 'Query' ⚠ Field 'so5Score' (deprecated) was removed from object type 'Query' ⚠ Field 'subscriptionStats' (deprecated) was removed from object type 'Query' ⚠ Field 'Query.season' is no longer deprecated ⚠ Field 'id' (deprecated) was removed from object type 'ReferralPaginated' ⚠ Field 'desktopBgImageUrl' (deprecated) was removed from object type 'ReferralTile' ⚠ Field 'desktopVariationBgImageUrl' (deprecated) was removed from object type 'ReferralTile' ⚠ Field 'mobileBgImageUrl' (deprecated) was removed from object type 'ReferralTile' ⚠ Field 'mobileVariationBgImageUrl' (deprecated) was removed from object type 'ReferralTile' ⚠ Field 'titleImageUrl' (deprecated) was removed from object type 'ReferralTile' ⚠ Field 'card' (deprecated) was removed from object type 'RewardCard' ⚠ Field 'card' (deprecated) was removed from object type 'SaleNotification' ⚠ Field 'card' (deprecated) was removed from object type 'So5Appearance' ⚠ Field 'game' (deprecated) was removed from object type 'So5Appearance' ⚠ Field 'baseballTeamsPlayingNextGameWeeks' (deprecated) was removed from object type 'So5Config' ⚠ Field 'basketballTeamsPlayingNextGameWeeks' (deprecated) was removed from object type 'So5Config' ⚠ Field 'footballTeamsPlayingNextGameWeeks' (deprecated) was removed from object type 'So5Config' ⚠ Field 'managerHomeContentUnitsSets' (deprecated) was removed from object type 'So5Config' ⚠ Field 'noCardRouteEmail' (deprecated) was removed from object type 'So5Config' ⚠ Field 'so5LeaguesAlgoliaFilters' (deprecated) was removed from object type 'So5Config' ⚠ Field 'hashedSalt' (deprecated) was removed from object type 'So5Fixture' ⚠ Field 'salt' (deprecated) was removed from object type 'So5Fixture' ⚠ Field 'so5LineupsFromRestrictionGroup' (deprecated) was removed from object type 'So5Fixture' ⚠ Field 'bench' (deprecated) was removed from object type 'So5Leaderboard' ⚠ Field 'challenges' (deprecated) was removed from object type 'So5Leaderboard' ⚠ Field 'enabled' (deprecated) was removed from object type 'So5Leaderboard' ⚠ Field 'hasFeaturedStarterPacks' (deprecated) was removed from object type 'So5Leaderboard' ⚠ Field 'myEligibleCards' (deprecated) was removed from object type 'So5Leaderboard' ⚠ Field 'myFeaturedStarterPacks' (deprecated) was removed from object type 'So5Leaderboard' ⚠ Field 'mustVerifyPhoneNumber' (deprecated) was removed from object type 'So5League' ⚠ Field 'restrictionGroup' (deprecated) was removed from object type 'So5League' ⚠ Field 'card' (deprecated) was removed from object type 'So5LineupNotification' ⚠ Field 'id' (deprecated) was removed from object type 'So5RankingsPaginated' ⚠ Field 'cardEdition' (deprecated) was removed from object type 'So5RewardCardConfig' ⚠ Field 'cardCollection' (deprecated) was removed from object type 'So5Root' ⚠ Field 'liveStarterPacks' (deprecated) was removed from object type 'So5Root' ⚠ Field 'managerHomeContentUnitsSets' (deprecated) was removed from object type 'So5Root' ⚠ Field 'myPodiums' (deprecated) was removed from object type 'So5Root' ⚠ Field 'myPodiumsDetails' (deprecated) was removed from object type 'So5Root' ⚠ Field 'userCardCollection' (deprecated) was removed from object type 'So5Root' ⚠ Field 'id' (deprecated) was removed from object type 'So5UserGroupMembershipsPaginated' ⚠ Field 'displayName' (deprecated) was removed from object type 'So5UserGroupTournament' ⚠ Field 'division' (deprecated) was removed from object type 'So5UserGroupTournament' ⚠ Field 'so5LeaderboardType' (deprecated) was removed from object type 'So5UserGroupTournament' ⚠ Field 'tournamentType' (deprecated) was removed from object type 'So5UserGroupTournament' ⚠ Field 'card' (deprecated) was removed from object type 'StarkwareWithdrawal' ⚠ Field 'position' (deprecated) was removed from object type 'SwappablePlayer' ⚠ Field 'card' (deprecated) was removed from object type 'Token' ⚠ Field 'favorited' (deprecated) was removed from object type 'Token' ⚠ Field 'amount' (deprecated) was removed from object type 'TokenBid' ⚠ Field 'amountInFiat' (deprecated) was removed from object type 'TokenBid' ⚠ Field 'maximumAmountInFiat' (deprecated) was removed from object type 'TokenBid' ⚠ Field 'amount' (deprecated) was removed from object type 'TokenMyBid' ⚠ Field 'amountInFiat' (deprecated) was removed from object type 'TokenMyBid' ⚠ Field 'maximumAmountInFiat' (deprecated) was removed from object type 'TokenMyBid' ⚠ Field 'amount' (deprecated) was removed from object type 'TokenPrice' ⚠ Field 'amountInFiat' (deprecated) was removed from object type 'TokenPrice' ⚠ Field 'subscribable' (deprecated) was removed from object type 'updateSubscriptionPayload' ⚠ Field 'subscriptionStats' (deprecated) was removed from object type 'updateSubscriptionPayload' ⚠ Field 'cardCounts' (deprecated) was removed from object type 'User' ⚠ Field 'paginatedCards' (deprecated) was removed from object type 'User' ⚠ Field 'amount' (deprecated) was removed from object type 'UserAccountEntry' ⚠ Field 'amountInFiat' (deprecated) was removed from object type 'UserAccountEntry' ⚠ Field 'cardCounts' (deprecated) was removed from object type 'UserWithSubscriptionSlug' ⚠ Field 'paginatedCards' (deprecated) was removed from object type 'UserWithSubscriptionSlug' ⚠ Field 'openedSo5Lineup' (deprecated) was removed from interface 'AnyCardInterface' ⚠ Field 'lastFifteenAverageScore' (deprecated) was removed from interface 'FootballRivalsDraftableObjectInterface' ⚠ Field 'completedOrReadyArenaStreakTask' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'division' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'eloGroup' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'eloScore' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'highestEloScore' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'highestScore' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'mostLossesAgainstOpponent' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'mostWinsAgainstOpponent' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'myUpcomingReceivedInvitesCount' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'readyArenaStreakTask' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'readyTask' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'records' (deprecated) was removed from interface 'FootballRivalsPublicManagerInterface' ⚠ Field 'cardCounts' (deprecated) was removed from interface 'PublicUserInfoInterface' ⚠ Field 'paginatedCards' (deprecated) was removed from interface 'PublicUserInfoInterface' ⚠ Field 'onboardingStatus' (deprecated) was removed from interface 'So5CurrentUserInterface'
✔ Field 'FootballRivalsCurrentManager.arenaUnlocked' is deprecated ✔ Field 'FootballRivalsCurrentManager.arenaUnlocked' has deprecation reason 'Not used anymore' ✔ Field 'FootballRivalsManager.arenaUnlocked' is deprecated ✔ Field 'FootballRivalsManager.arenaUnlocked' has deprecation reason 'Not used anymore' ✔ Field 'FootballRoot.season' is deprecated ✔ Field 'FootballRoot.season' has deprecation reason 'Use season on root instead' ✔ Field 'Query.so5LeaderboardGroupInterface' is deprecated ✔ Field 'Query.so5LeaderboardGroupInterface' has deprecation reason 'Use so5.so5LeaderboardGroupInterface' ✔ Field 'UserOwner.ownerable' is deprecated ✔ Field 'UserOwner.ownerable' has deprecation reason 'Use account instead' ✔ Field 'FootballRivalsPublicManagerInterface.arenaUnlocked' is deprecated ✔ Field 'FootballRivalsPublicManagerInterface.arenaUnlocked' has deprecation reason 'Not used anymore'
Introduce concurrent queries throttling: user will now be limited to 40 queries inflight at the same time.
Many fields that had been deprecated for more than 3 months have been removed. Some new deprecation have also been introduced.
✖️ Input field 'prepareBidInput.auctionId' changed type from 'String' to 'String!'
✔️ Field 'Card.availableCardBoosters' is deprecated ✔️ Field 'Card.availableCardBoosters' has deprecation reason 'Deprecated' ✔️ Deprecation reason on field 'Card.availableUserShopItems' has changed from 'Use availableCardBoosters' to 'Deprecated' ✔️ Field 'CardSubscription.availableCardBoosters' is deprecated ✔️ Field 'CardSubscription.availableCardBoosters' has deprecation reason 'Deprecated' ✔️ Deprecation reason on field 'CardSubscription.availableUserShopItems' has changed from 'Use availableCardBoosters' to 'Deprecated' ✔️ Deprecation reason was removed from field 'Onboarding.id' ✔️ Field 'Query.ethereumTokens' is deprecated ✔️ Field 'Query.ethereumTokens' has deprecation reason 'Use ethereumCards instead' ✔️ Field 'TokenRoot.allNfts' is deprecated ✔️ Field 'TokenRoot.allNfts' has deprecation reason 'Use allCards instead' ✔️ Field 'TopGainers.player' is deprecated ✔️ Field 'TopGainers.player' has deprecation reason 'Use anyPlayer instead' ✔️ Field 'TopVolume.player' is deprecated ✔️ Field 'TopVolume.player' has deprecation reason 'Use anyPlayer instead'
✔️ Field 'allCards' was added to object type 'TokenRoot'
Most baseball related queries and mutations have been deprecatred in favor of using the same API as football. The same will happen to all NBA queries and mutations during the summer. The following queries and mutations have been deprecated.
baseballCard
useanyCard
insteadbaseballCards
useanyCards
insteadbaseballFixture
useso5Fixture
insteadbaseballLeaderboard
access throughso5Fixture
baseballLiveFixture
useso5Fixture
insteadbaseballOpenFixture
useso5Fixture
insteadbaseballPastFixtures
useso5Fixtures
insteadbaseballPlayer
useanyPlayer
insteadbaseballPlayers
useanyPlayers
insteadbaseballReferralRewards
baseballTeam
useteam
insteadbaseballLeague
baseballLineup
useso5Lineup
insteadbaseballLineups
useso5Lineups
insteadbaseballStarterBundles
baseballGame
useanyGame
insteadbaseballShop
useshopItems
insteadbaseballCumulativeLeaderboard
claimBaseballRewards
claimBaseballReferralRewards
createBaseballLeague
joinBaseballLeague
leaveBaseballLeague
createOrUpdateBaseballLineup
deleteBaseballLineup
buyBaseballShopItem
claimBaseballCoinRewards
Removed the following field:
currentUser.jwtToken
, prefer using either explicitcreateJwtToken
mutation orjwtToken
field which can be found on any of the mutations you can use to sign in.
Remove the following fields (previously deprecated):
nationalTeam
(usefootball.nationalTeam
instead)nationalTeams
(usefootball.nationalTeams
instead)
Deprecated the following field:
currentUser.jwtToken
, prefer using either explicitcreateJwtToken
mutation orjwtToken
field which can be found on any of the mutations you can use to sign in.
The following deprecated types as well as their associated fields have been removed in favor of CurrentUser
:
CurrentNBAUser
CurrentSportsUser
Added DIRECT_OFFER
accepted events to the set of events covered by the tokenOfferWasUpdated
subscription.
Limit the number of allowed teamSlugs
within cards field arguments. Impacted fields include: allCards
, cards
, paginatedCards
, footballCards
, football.cards
, football.allCards
, team.cards
, player.cards
.
Deprecated the following field:
user.customDecks
(useuser.footballUserProfile.decks
instead)
Dropped the following deprecated fields:
card.customDecks
(usecard.token.decks
instead)cardSubscription.customDecks
(usecardSubscription.token.decks
instead)
Dropped the following mutations:
addCardsToDeck
(useaddTokensToDeck
instead)createCustomDeck
(usecreateDeck
instead)deleteCustomDeck
(usedeleteDeck
instead)editCardInDeck
(support for ordering has been dropped)editCustomDeck
(useeditDeck
instead)removeCardFromDeck
(useremoveTokenFromDeck
instead)
Deprecation of the following fields (these were actually deprecated on 10/31/23 but has not caught up in the document. Will keep the fields for at least 1 month from the documentation):
PrizePoolPodiumPrizeInterface.cardRarity
(usePrizePoolPodiumPrizeInterface.cards
instead)PrizePoolPodiumPrizeInterface.cardTier
(usePrizePoolPodiumPrizeInterface.cards
instead)
Deprecation of the following arguments:
prepareOffer.type
: Not replacedprepareOffer.receiverSlug
: Not replaced
Dropped the following deprecated fields:
user.highlightedDeck
: UseuserSportProfile.highlightedDeck
deckInFormation
: no longer maintainedfootball.deckInFormation
: no longer maintained
Starting from 10/30/2023, the id
field of the User
and CurrentUser
types will always be returned with the following format: User:<id>
. Before this date, the format was inconsistent between <id>
and User:<id>
depending on the query.
Deprecated the following fields:
card.customDecks
(usecard.token.decks
instead)cardSubscription.customDecks
(usecardSubscription.token.decks
instead)
Deprecated the following mutations:
addCardsToDeck
(useaddTokensToDeck
instead)createCustomDeck
(usecreateDeck
instead)deleteCustomDeck
(usedeleteDeck
instead)editCardInDeck
(support for ordering will be dropped)editCustomDeck
(useeditDeck
instead)removeCardFromDeck
(useremoveTokenFromDeck
instead)
Dropped the following deprecated fields:
transferMarket
: Usetokens
Dropped the following deprecated fields:
offer.priceWei
offer.priceFiat
Deprecation of the following fields:
offer.priceWei
: Useoffer.senderSide.amounts
andoffer.receiverSide.amounts
offer.priceFiat
: Useoffer.senderSide.amounts
andoffer.receiverSide.amounts
NOTE: when reading a MonetaryAmount field (such as offer.receiverSide.amounts
), the object may not contain a value for each supported currencies. The amounts.referenceCurrency
tells which currency is fixed.
Deprecation of the following fields:
user.highlightedDeck
: UseuserSportProfile.highlightedDeck
deckInFormation
: no longer maintainedfootball.deckInFormation
: no longer maintained
The GraphQL introspection has been disabled on deprecated API endpoints: https://api.sorare.com/graphql and https://api.sorare.com/sports/graphql
Dropped several deprecated fields linked to legacy market
-
token.collectionName
: Usecollection
-
config.walletUrl
-
config.frontendAssetHost
-
auctionNotification.auction
: UsetokenAuction
-
auctionNotification.bid
: UsetokenBid
-
bid.englishAuction
: UsetokenAuction
Dropped legacy subscriptions:
bundledAuctionWasUpdated
publicMarketWasUpdated
Dropped several deprecated fields linked to legacy market
-
card.onSale
: Usetoken
fields -
card.openEnglishAuction
: Usetoken
fields -
card.liveSingleSaleOffer
: 'UseToken.liveSingleSaleOffer
-
card.myMintedSingleSaleOffer
: UseToken.myMintedSingleSaleOffer
-
card.liveSingleBuyOffers
: UseToken.liveSingleBuyOffers
-
card.latestEnglishAuction
: UseToken.latestEnglishAuction
-
card.canBuy
: UseToken.tradeableStatus
-
card.publicMinPrice
: UseToken.publicMinPrice
-
card.privateMinPrice
: UseToken.privateMinPrice
-
transferMarket
: Usetokens
-
englishAuction
: Usetokens
.auction -
bundledAuction
: Usetokens
.auction -
directOffers
: UsetokenOffers
-
pendingDirectOffersSent
: UsependingTokenOffersSent
-
endedDirectOffersSent
: UseendedTokenOffersSent
-
pendingDirectOffersReceived
: UsependingTokenOffersReceived
-
endedDirectOffersReceived
: UseendedTokenOffersReceived
-
user.buyingEnglishAuctions
: UsebuyingTokenAuctions
-
user.englishAuctions
: UsetokenAuctions
-
user.wonEnglishAuctions
: UsewonTokenAuctions
-
user.lostEnglishAuctions
: UselostTokenAuctions
-
user.liveSingleSaleOffers
: UseliveSingleSaleTokenOffers
-
user.paginatedLiveSingleSaleOffers
: UseliveSingleSaleTokenOffers
-
user.soldSingleSaleOffers
: UsesoldSingleSaleTokenOffers
-
user.endedWithNoBuyersSingleSaleOffers
: UseendedWithNoBuyerSingleSaleTokenOffers
-
user.boughtSingleSaleOffers
: UseboughtSingleSaleTokenOffers
-
user.singleSaleOffers
: UsesingleSaleTokenOffers
-
user.fastWithdrawal
: UseprepareFastWithdrawal
mutation -
auction.contentProvider
Introduce new tokens
fields to easily iterate over all live offers, primary offers & auctions.
tokens.liveSingleSaleOffers
&TokenOffer.updatedAt
tokens.liveAuctions
&TokenAuction.updatedAt
tokens.livePrimaryOffers
&TokenPrimaryOffer.updatedAt
The following fields are now required:
bid.settlementInfo
bid.approvals
acceptOffer.approvals
createDirectOffer.approvals
createSingleSaleOffer.approvals
The following deprecated fields have been removed:
createSingleSaleOffer.starkSignatures
createDirectOffer.starkSignatures
acceptOffer.starkSignatures
prepareAcceptOffer.dealId
acceptOffer.blockchainId
acceptOffer.conversionCreditId
prepareBid.conversionCreditId
bid.conversionCreditId
Deprecated the following fields:
prepareBid.limitOrders
: useauthorizations
prepareAcceptOffer.limitOrders
: useauthorizations
prepareOffer.sendWeiAmount
: usesendAmount
prepareOffer.receiveWeiAmount
: usereceiveAmount
createSingleSaleOffer.price
: usereceiveAmount
createDirectOffer.sendWeiAmount
: usesendAmount
createDirectOffer.receiveWeiAmount
: usereceiveAmount
createOrUpdateSinglyBuyOfferMinPrice.amount
: useminPrice
The API to bid, create offers, and accept offers have been updated. See README.md and code examples for details.
Deprecated the following fields:
-
prepareOffer.sendWeiAmount
: usesendAmount
-
prepareOffer.receiveWeiAmount
: usereceiveAmount
-
createSingleSaleOffer.price
: usereceiveAmount
-
createSingleSaleOffer.starkSignatures
: useapprovals
-
createDirectOffer.sendWeiAmount
: usesendAmount
-
createDirectOffer.receiveWeiAmount
: usereceiveAmount
-
createDirectOffer.starkSignatures
: useapprovals
-
acceptOffer.starkSignatures
: useapprovals
Deprecated the following fields:
prepareBid.bidAmountWei
: useamount
prepareBid.conversionCreditId
: usesettlementInfo.conversionCreditId
bid.conversionCreditId
: usesettlementInfo.conversionCreditId
bid.starkSignatures
: useapprovals
Deprecated the following field:
currentUser.fastWithdrawal
: useprepareFastWithdrawal
mutation
Deprecated the following mutation:
createSingleBuyOffer
: usecreateDirectOffer
Deprecated the following fields:
currentUser.paginatedLiveSingleSaleOffers
: useliveSingleSaleTokenOffers
currentUser.soldSingleSaleOffers
: usesoldSingleSaleTokenOffers
currentUser.endedWithNoBuyerSingleSaleOffers
: useendedWithNoBuyerSingleSaleTokenOffers
currentUser.boughtSingleSaleOffers
: useboughtSingleSaleTokenOffers
currentUser.singleSaleOffers
: usesingleSaleTokenOffers
createSingleSaleOffer.offer
: usetokenOffer
Deprecated the following subscription types:
offerWasUpdated
: usetokenOfferWasUpdated
Deprecated the following fields:
acceptOffer.offer
: usetokenOffer
cancelOffer.offer
: usetokenOffer
createDirectOffer.offer
: usetokenOffer
createSingleBuyOffer.offer
: usetokenOffer
rejectOffer.offer
: usetokenOffer
offerNotification.offer
: usetokenOffer
currentUser.buyingEnglishAuctions
: usebuyingTokenAuctions
currentUser.englishAuctions
: usetokenAuctions
currentUser.wonEnglishAuctions
: usewonTokenAuctions
currentUser.lostEnglishAuctions
: uselostTokenAuctions
bid.englishAuctions
: usetokenAuction
Deprecated the following fields:
payment.operation
: usetokenOperation
accountEntry.operation
: usetokenOperation
Deprecated the following subscription types:
bundledAuctionWasUpdated
: usetokenAuctionWasUpdated
Deprecated the following fields:
transferMarket
: usetokens
bundledAuction
: usetokens.auction
englishAuction
: usetokens.auction
auctionNotification.auction
: useauctionNotification.tokenAuction
auctionNotification.bid
: useauctionNotification.tokenBid
mutation.bid.bid
: usemutation.bid.tokenBid
https://api.sorare.com/federation/graphql is the new Sorare API endpoint. It's a federated superset of the existing API endpoints so all existing queries remain valid, just replace the URL in your application. You can use it for all queries, independently of the sport; for instance, you can now fetch NBA card prices in a single query:
query GetNBACardsPrices($slugs: [String!]!) {
nbaCards(slugs: $slugs)
token {
latestEnglishAuction {
bestBid {
amount
amountInFiat { eur gbp usd }
}
}
}
}
}
The playground is available at https://api.sorare.com/federation/graphql/playground.
https://api.sorare.com/graphql and https://api.sorare.com/sports/graphql are deprecated and will be shut down in a few months to let time for everyone to migrate.
Deprecated the following subscription types:
publicMarketWasUpdated
: usetokenAuctionWasUpdated
ortokenOfferWasUpdated
instead
Deprecated the following fields:
so5.cardCollection
: usefootball.cardCollection
so5.userCardCollection
: usefootball.userCardCollection
createDirectOfferInput.duration
: value now defaults to 86400 (1 day) if given a lower value
Deprecated the following fields:
so5
: usefootball.so5
so5Reward
: usefootball.so5.so5Reward
so5Lineup
: usefootball.so5.so5Lineup
so5Appearance
: usefootball.so5.so5Appearance
so5League
: usefootball.so5.so5League
so5Leaderboard
: usefootball.so5.so5Leaderboard
so5Score
: usefootball.so5.so5Score
so5Ranking
: usefootball.so5.so5Ranking
Deprecated the following fields:
competition
: usefootball.competition
game
: usefootball.game
card
: usefootball.card
cardByBlockchainId
: usefootball.cardByBlockchainId
cardByAssetId
: usefootball.cardByAssetId
ethereumCards
: usefootball.ethereumCards
players
: usefootball.players
player
: usefootball.player
club
: usefootball.club
clubs
: usefootball.clubs
nationalTeam
: usefootball.nationalTeam
nationalTeams
: usefootball.nationalTeams
clubsReady
: usefootball.clubsReady
season
: usefootball.season
deckInFormation
: usefootball.deckInFormation
customDeck
: usefootball.customDeck
shopItems
: usefootball.shopItems
cards
: usefootball.cards
allCards
: usefootball.allCards
Additional paginated fields are now accessible:
sportsUser.nbaCards
sportsUser.baseballCards
NBAPlayer.cards
BaseballPlayer.cards
Removed the following deprecated fields:
UserSettings.lastTcuVersionAccepted
Deprecated the following field:
UserSettings.referrerPreferredRewardSport
: no longer used
Removed the following deprecated field:
Card.priceRange
The following fields from the Card
object are deprecated and should be replaced by their equivalent on the Token
object:
onSale
openEnglishAuction
: useToken.latestEnglishAuction
liveSingleSaleOffer
: useToken.liveSingleSaleOffer
myMintedSingleSaleOffer
: useToken.myMintedSingleSaleOffer
liveSingleBuyOffer
: useToken.liveSingleBuyOffers
latestEnglishAuction
: useToken.latestEnglishAuction
canBuy
: useToken.tradeableStatus
publicMinPrice
: useToken.publicMinPrice
privateMinPrice
: useToken.privateMinPrice
Removed the following deprecated fields:
See the list
Account.oldId
: use idCard.belongsToUser
Card.canSell
Card.cardEdition
Card.cardPrint
: use cardEdition and layout insteadCard.club
: replaced by teamCard.currentSeasonBonus
: replaced by power breakdownCard.gameForFixture
: use gameForLeague insteadCard.layout
Card.license
Card.nextVaultId
: not needed. This info is provided in prepare mutationsCard.owners
: use notContractOwnersCard.playerInjuries
Card.price
: not relevantCard.sameClubBonus
: replaced by power breakdownCard.scoreForPreviousFixture
: use the So5Scores of the player insteadCard.teamPictureUrl
: use pictureUrl on team insteadCard.userOwnerWithRate
: replaced by ownerWithRateCard.userOwners
: use notContractOwnersCard.userOwnersWithRate
: use notContractOwnersCard.vaultId
: not needed. This info is provided in prepare mutationsCardSubscription.belongsToUser
CardSubscription.canSell
CardSubscription.cardEdition
CardSubscription.cardPrint
: use cardEdition and layout insteadCardSubscription.club
: replaced by teamCardSubscription.currentSeasonBonus
: replaced by power breakdownCardSubscription.gameForFixture
: use gameForLeague insteadCardSubscription.layout
CardSubscription.license
CardSubscription.nextVaultId
: not needed. This info is provided in prepare mutationsCardSubscription.owners
: use notContractOwnersCardSubscription.playerInjuries
CardSubscription.price
: not relevantCardSubscription.sameClubBonus
: replaced by power breakdownCardSubscription.scoreForPreviousFixture
: use the So5Scores of the player insteadCardSubscription.teamPictureUrl
: use pictureUrl on team insteadCardSubscription.userOwnerWithRate
: replaced by ownerWithRateCardSubscription.userOwners
: use notContractOwnersCardSubscription.userOwnersWithRate
: use notContractOwnersCardSubscription.vaultId
: not needed. This info is provided in prepare mutationsClub.colorBottom
: replaced by colorRight on customBannerClub.colorTop
: replaced by colorLeft on customBannerClub.license
: only exposed on cardsClub.partner
: replaced by dataPartnerClub.pictureUrlByRarity
: replaced teamPictureUrl on CardTypeConfig.activateStarkware
Config.cardPowerCap
Config.cdnEnabled
Config.draftMajorCompetitions
: draft does not exist anymoreConfig.landingCards
: replaced by landingThemeConfig.nextSo5FixtureTeams
: moved to so5Config.powerHourStartDate
: no longer maintainedConfig.so5LeaguesAlgoliaFilters
: moved to so5Config.transferMarketBanner
: moved to TransferMarketTypeCurrentUser.allTimeBestDecksInFormation
: no longer maintainedGame.away
: replaced by awayTeamGame.home
: replaced by homeTeamMembership.team
: replaced by membershipTeamNationalTeam.colorBottom
: replaced by colorRight on customBannerNationalTeam.colorTop
: replaced by colorLeft on customBannerNationalTeam.license
: only exposed on cardsNationalTeam.partner
: replaced by dataPartnerNationalTeam.pictureUrlByRarity
: replaced teamPictureUrl on CardTypeOffer.receiveCardOffers
: use receiveCards insteadOffer.sendCardOffers
: use sendCards insteadOwner.dealId
: no longer maintainedOwner.migratorApproval
: use account.accountable.migratorApprovedOwner.newId
: use idOwner.ownerable
: use account.owner insteadOwner.userNonce
: no longer maintainedOwnerInterface.dealId
: no longer maintainedOwnerInterface.migratorApproval
: use account.accountable.migratorApprovedOwnerInterface.newId
: use idOwnerInterface.userNonce
: no longer maintainedOwnerWithRates.dealId
: no longer maintainedOwnerWithRates.migratorApproval
: use account.accountable.migratorApprovedOwnerWithRates.newId
: use idOwnerWithRates.ownerable
: use account.owner insteadOwnerWithRates.userNonce
: no longer maintainedPlayer.position
: use the typed version instead: positionTypedPlayer.tmktImageUrl
: replaced by pictureUrl(derivative: "avatar")PlayerGameStats.club
: replaced by teamPlayerGameStats.gameStatus
: replaced by status on game fieldPlayerGameStats.relevantStats
: not relevant with scoring V4PublicUserInfoInterface.allTimeBestDecksInFormation
: no longer maintainedQuery.bundledAuctions
: use transferMarket type insteadQuery.cardEdition
: no longer maintainedQuery.cardSamplePicture
: use screenshottableCardQuery.clubShopItems
: use shopItemsQuery.currentSo5Fixture
: use default value of so5FixtureQuery.pack
: no longer maintainedQuery.packs
: no longer maintainedQuery.singleSaleOffers
: use transferMarket type insteadQuery.so5Fixtures
: moved into so5So5Appearance.score
: use score under so5ScoreSo5Appearance.so5Game
: no longer maintainedSo5Fixture.appearancesInFixtureInterval
: can be found with mySo5LineupsSo5Fixture.commonDraftCampaignSo5Leaderboard
: no longer maintainedSo5Fixture.myRecommendedSo5Leaderboards
: use sorted leaderboards insteadSo5Fixture.so5Rewards
: use leaderboard rewards insteadSo5Leaderboard.name
: replaced by titleSo5Leaderboard.rewards
: replaced by rewardsConfigSo5Leaderboard.scoringEngine
: replaced by engineConfigurationSo5Leaderboard.shieldName
: not in use anymoreSo5Leaderboard.so5Lineups
: use so5LineupsPaginated insteadSo5League.description
: no longer maintainedSo5Lineup.score
: use so5Rankings.scoreSo5Reward.cards
: replaced by rewardCardsSo5Reward.ranking
: replaced by so5RankingSo5Rules.averageScorePlayersCount
: no longer maintainedSo5Rules.clubs
: no longer maintainedSo5Rules.maxAge
: replaced by ageSo5Rules.minAge
: replaced by ageSo5Rules.sameClub
: no longer maintainedSo5UserGroup.commonDraftCampaignSo5Leaderboard
: no longer maintainedSubscription.packWasSold
: not used anymoreTeamInterface.colorBottom
: replaced by colorRight on customBannerTeamInterface.colorTop
: replaced by colorLeft on customBannerTeamInterface.license
: only exposed on cardsTeamInterface.partner
: replaced by dataPartnerTeamInterface.pictureUrlByRarity
: replaced teamPictureUrl on CardTypeToken.latestOwner
TransferMarket.banners
: use ConfigType.heroBannersTransferMarket.bundlesFirst
TransferMarket.secondaryBanners
: use ConfigType.bannersUser.allTimeBestDecksInFormation
: no longer maintainedUserOwner.dealId
: no longer maintainedUserOwner.migratorApproval
: use account.accountable.migratorApprovedUserOwner.newId
: use idUserOwner.userNonce
: no longer maintainedUserWithSubscriptionSlug.allTimeBestDecksInFormation
: no longer maintained
Removed the following values from the TradableStatus
which were no longer emitted:
INTERNAL
MAPPED
ON_SALE
Removed the following queries from the Sports API:
user
Deprecated the following currentUser
fields:
directOffers
: usetokenOffers
pendingDirectOffersSent
: usependingTokenOffersSent
endedDirectOffersSent
: useendedTokenOffersSent
pendingDirectOffersReceived
: usependingTokenOffersReceived
endedDirectOffersReceived
: useendedTokenOffersReceived
Removed the following queries from the Sports API:
card
cards
player
lineup
Removed the following mutations from the Sports API:
completeOnboardingTask
createOrUpdateLineup
Deprecated the following queries from the Sports API:
user
: usesportsUser
Deprecated the following queries from the Sports API:
currentNBAUser
: usecurrentSportsUser
Removed the following deprecated fields from the Sports API:
NBACompleteOnboardingTaskResponse.currentUser
BaseballCompleteOnboardingTaskResponse.currentUser
Deprecated the following mutations from the Sports API:
createOrUpdateLineup
: usecreateOrUpdateBaseballLineup
deleteLineup
: usedeleteBaseballLineup
Deprecated the following queries from the Sports API:
lineup
: usebaseballLineup
completeOnboardingTask
: usecompleteBaseballOnboardingTask
cards
: usebaseballCards
Removed the following deprecated queries from the Sports API:
currentUser
fixture
leaderboard
liveFixture
openFixture
pastFixtures
team
Deprecated the following field from prepareOffer
:
cardSlug
: useassetId
Deprecated the following field from createOrUpdateSingleBuyOfferMinPrice
:
cardSlug
: useassetId
Deprecated the following fields from createDirectOffer
:
sendCardsSlugs
: usesendAssetIds
receiveCardsSlugs
: usereceiveAssetIds
Deprecated the following fields from createSingleSaleOffer
:
cardSlug
: useassetId
Deprecated the following fields from createSingleBuyOffer
:
cardSlug
: useassetId
GraphQL complexity limits have been updated to reflect a change in the computation algorithm. Some array-based GraphQL fields were not accounted for and will now be taken into account (eg. soScore.allAroundStats
or englishAuction.cards
). The new algorithm computes GraphQL complexity that are generally higher than the old one so we have bumped the (authenticated) limit to 30k.
Clarified subscription complexity limits.
currentUser.accountEntries
now returns entries related to market fees (where entry type is PAYMENT_FEE
) and is also filterable on the entryType
field.
A query tokenPrices
has been added. It returns the last 5 public prices (either from Auction or SingleSaleOffer) for a given player, rarity and collection.
- When creating a
SingleSaleOffer
through thecreateSingleSaleOffer
mutation, thestart_date
now defaults to "2 minutes in the future" (instead of the current timestamp). This creates a grace period during which the offer can be canceled before it becomes public.
Deprecated the following field from So5Leaderboard
:
scoringEngine
Deprecated the following field from Card
:
priceRange
(useToken.priceRange
instead, which works across collections)
A feeInfo
field of type Fee
is added on LimitOrder
type and is now mandatory on the following mutation when interacting with the secondary market:
- for direct offer creation:
prepareOffer
mutation. - for single sale offer acceptance:
prepareAcceptOffer
mutation, see the updated example.
This new feeInfo
field must be part of the payload that will be signed with the signLimitOrder
method
provided by the @sorare/crypto
package or any other method you will use.
Please note that these changes are only required for offers containing MLB or NBA cards, and an ETH amount.
Added the following field on Offer
and SingleSaleOffer
:
marketFeeWeiAmount
Added the following fields on TokenOffer
:
marketFeeAmountWei
marketFeeAmountFiat
Removed the following deprecated fields from Card
:
currentUserSingleBuyOfferMinPrice
publicSingleBuyOfferMinPrice
Added the following argument on PublicUserInfoInterface.paginatedCards
and WithPublicCardsInterface.cards
:
ownedSinceAfter
Added the following arguments on *.cards
:
teamSlugs
playerSlugs
Added the following argument on *.cards
:
customCardEditionName
Added the following field on So5RewardCardConfig
:
customCardEditionName
Deprecated the following root field
cardEdition
Deprecated the following fields on Card
cardEdition
layout
license
Deprecated the following fields on So5RewardCardConfig
cardEdition
Added the following argument on PlayerGameStats.so5Score
:
position
Deprecated the following field on CurrentUser
otpBackupCodes
Welcome Sorare: MLB GraphQL API!!
Added sport-agnostic GraphQL types:
Token
TokenOffer
TokenAuction
TokenBid
Added sport-agnostic GraphQL subscriptions:
tokenOfferWasUpdated
tokenAuctionWasUpdated
Removed the following deprecated field from Card
:
mintedSingleSaleOffer
The AccountType id
format has been changed to an UUID. The old id format is exposed in a deprecated oldId
field.
Deprecated the following field on Owner
newId
Removed the following deprecated fields from EnglishAuction
:
card
name
contract
limitOrders
Removed the following deprecated fields from Account
:
escrowAccount
sorareManaged
Removed the following deprecated fields from PaymentIntent
:
saveCard
Removed the following deprecated fields from SingleSaleOffer
:
belongsToUser
actualReceiver
Deprecated the following field from the SignUp
mutation:
invitationToken
(no longer supported, now ignored)
Document complexity and depth limitations on GraphQL queries.
Removing the following field (deprecated on 2022-02-01):
UserProfile
:
slug
Some deprecated auction and offer fiels have been removed
Offer
:
minSignatureExpirationDate
mintedAt
receiverLimitOrders
contract
ethereumTransaction
Auction
:
minSignatureExpirationDate
number
belongsToUser
bestBidBelongsToUser
Some deprecated card and player fields have been removed:
Card
:
cardSampleUrl
draftValue
Player
:
releasedPlayerValues
Deprecated market fields have been removed:
Card
:
openAuction
latestAuction
Country
:
openAuctions
Player
:
openAuctions
Team
:
openAuctions
User
:
cards
allTimeBestDecks
openAuctions
openEnglishAuctions
auctions
wonAuctions
lostAuctions
endedBuyingAuctions
buyingAuctions
Root
:
auctions
transferMarket
:
auctions
bundledAuctions
englishAuction
:
deal
offer
:
deal
- The
ids
argument to thenodes
root field is now limited to only 100 elements.
Team
:
openAuctions
All currentUser fields that were deprecated have been removed.
CurrentUser
:
firstName
lastName
nextStarkwareNonce
betaStarker
remainingRookieGameWeeks
blockedBy
draftAvailableFunds
frontChatUserHash
directOffersSent
directOffersReceived
blocked
subscriptions
starkRegistrationSignature
aCardWasUpdated
now takes the optionalevents
parameter to filter subscriptions
EthereumAccount
:
migratorApproved
Offer
:
sendCards
receiveCards
Account
:
escrowAccount
sorareManaged
Offer
:
minSignatureExpirationDate
contract
ethereumTransaction
sendCardOffers
receiveCardOffers
EnglishAuction
:
contract
minSignatureExpirationDate
name
limitOrders
Offer
:
receiverLimitOrders
deal
- Deprecate
CardPrint
andRaritiesCardLayout
types (were only accessible through deprecated fields) - Always return an empty object for
CardPrint.backgroundUrlByRarity
- Remove
deck
root field (had been deprecated for a while) - Force passing the
slugs
argument for thecards
root field
publicMarketWasUpdated
subscription has been introduced:. It triggers every time a card is updated on a public market (auction and single sale offers): on a bid, when an auction ends, when a single sale offer is accepted.
-
slug
field is now deprecated on theUserProfile
type. You should be using theid
field instead. -
the
aCardWasUpdated
subscription now takes the following optional arguments to filter subscriptions:ages
cardEditions
playerSlugs
positions
owned
rarities
seasonStartYears
serialNumbers
shirtNumbers
slugs
cards
andallCards
queries and connections can now take the following arguments:age
owned
positions
rarities
serialNumber
shirtNumber
slugs
- added a new
season
query - added a new
cardEdition
query
- the
dealId
field is now part ofUserOwnerWithRates
object.
- the
channelId
component of the WebSocketactioncable-v1-json
sub-protocol is not required anymore. - the
Origin
HTTP header is not required anymore while queryingwss://ws.sorare.com/cable
.
- improved 404 error messages
- whenever rate-limited, a
Retry-After
HTTP header will be added to the response to understand how much time to wait before retrying.
Some high-cardinality sets of objects won't be retrievable while being nested in a collection/connection. (eg. you can retrieve the followers of a single User but won't be able to retrieve them on multiple users in a single GraphQL query). This applies to:
- user.followers
- user.following
- user.buyingEnglishAuctions
- user.paginatedLiveSingleSaleOffers
- user.endedWithNoBuyerSingleSaleOffers
- country.openAuctions
- user.customDecks
- team.openAuctions
- team.players
- team.activePlayers
- team.recentDepartures
- team.activeMemberships
- team.latestGames
- team.games
- card.playerSeasonPicture
- card.teamPictureUrl
- competition.clubs
- so5Fixture.so5Leagues
- so5Fixture.mySo5Lineups
- so5Fixture.mySo5Games
- so5Fixture.so5Leaderboards
- so5Fixture.mySo5Rewards
- so5Fixture.mySo5Rankings
- so5Fixture.orderedSo5Scores
- so5Fixture.orderedSo5ScoresByPosition
- so5Fixture.next
- so5Fixture.previous
- so5Leaderboard.so5Rankings
- so5Leaderboard.so5RankingsPreview
- so5Leaderboard.so5Rewards
- so5Leaderboard.so5LineupsPaginated
- so5Leaderboard.so5RankingsPaginated
Some fields have been removed from the API. They have been marked as deprecated and you can still query them for now but the response will always be empty. This applies to:
- currentUser.subscriptions
- so5Leaderboard.so5Lineups
- so5Appearance.so5Game
- card.mintedSingleSaleOffer
Additional fields are now accessible to OAuth authenticated calls. This applies to:
- card.myMintedSingleSaleOffer
- card.currentUserSingleBuyOfferMinPrice
- card.liveSingleBuyOffers
- card.canBuy
- currentUser.followers
- currentUser.following