Sandbox API Asks

Hi all,

I want to start the conversation around what a Sandbox API would look like. I think the timing is too early to put to a vote at the moment, given I want to see what 0.12 has with respect to saved variables, but it will still be useful to coalesce what everyone wants from an API in one place until then.

Here are my thoughts on the data we want, I will continue to edit as people add suggestions:

  • Player
    • Wallet Address
    • KYC status (true or false only, no details)
    • Player Experience Information
      • All saved variables and their values (excluding variables that reset when you restart the experience)
        • Example:
          • Cryptodiplo, timeout 4, course time: 00:05:34
      • All quests and true/false if completed or not
      • Total Playtime
  • Experience
    • Highscores
      • Full list of rank, player, and score

The idea here is that if we have access to this data about our players we can make outside tech that engages our players without having the Sandbox need to make everything for us. Things like showing highscores for more than one variable, giving NFT and token airdrops to players, making standalone game websites where you can see all your stats, etc.

8 Likes

Yup, fully concur with this. Would be just as helpful as having an inventory filter :laughing:

2 Likes

Thoughts from other @Delegates ?

Feel free to also tag community members who might have input and/or wish to author or otherwise advance this idea.

1 Like

Hello,

FYI on the API topic I’m trying to have The Sandbox “creator API” opened to more (namely WakeUps labs for the UGC website). It is only reserved to a couple of studios at the moment. Not exactly the same scope, but adjacent.

5 Likes

Very interesting @Cyril, do you know what data that contains / is there any documentation on it?

1 Like

tagging others for input @yuelwolf @Money @Ivey @SasanSeyedi.eth @Gonzacolo @KamiSawZe @TheVisionEx @DrMetaverso

3 Likes

Thanks for the tag! I don’t claim to be a developer, but any positive growth of API usage and data availability can only be seen as positive IMHO. Giving the ability to do more, create and build can only enhance the player experience and community activity.

2 Likes

I’m def pro API. Lot of times is the first thing I google before jumping into a platform. Curious what kind of data SB is willing to share. @cryptodiplo summary is good place to start. :fire:

2 Likes

I’d love to see more assets related, like tracking ownership and pricing details.

2 Likes

This definitely sounds good! I think the list that @cryptodiplo has provided is rather comprehensive.

3 Likes

Hello everyone

This topic is also very important for Chrysalis Quest. Thanks for the tag, @cryptodiplo . We had previously requested the following features to be considered for the Creators API:

  • Access to missions associated with a specific experience.
  • Data on users who have completed a mission and/or the entire experience (if it has a defined ending).
  • Playtime per user (extremely valuable for analytics).
  • Access to in-game variables.
  • Access to user data, including: published experiences, minted assets, and avatars.
3 Likes

@yuelwolf Super helpful. Does this API exist yet at all? and if so what does it have?

Will add your asks if they do not already exist.

1 Like

Hey @CryptoDiplo, thanks for bringing this up — it’s a crucial conversation to have.

Most major projects involving user-generated content eventually offer APIs and tools for third-party integration once their games are stable and ready to scale with the community.

This pattern is clear across several leading ecosystems:

And the need becomes even more obvious once you start building — something we experienced firsthand during the early development of SIP-19.

Robust public APIs would enable third-party builders to:

  • Tracking and rewarding player activity
  • Cross-platform login ID connections
  • Access to real user metrics
  • Simple on/off-chain data integration
  • On/off ramps and player incentive mechanisms
  • Linking users to their assets across on- and off-chain environments

As we (@wakeuplabs) noted in the SIP-19 posts with @miki, we highlighted several blockers and outlined concrete API needs.

With the right infrastructure, products built by the community could be far more scalable, dynamic, and meaningful for end users.


That said, just asking for this kind of development isn’t enough.

While, this kind of initiative should start with builders and users who can define what’s needed and why, we also need to be realistic:

Recognizing the need doesn’t automatically make it a priority.

The Sandbox team is already handling critical tasks like:

  • Ensuring the game builder performs reliably
  • Keeping on-chain payments secure
  • Maintaining platform stability

They’re also likely focused on long-term improvements that fall within their existing roadmap.

And that’s completely fair.

It’s not the DAO’s role to reprioritize The Sandbox Company’s internal roadmap.

Instead, the DAO should focus on proposing initiatives that it can fully execute independently, with the right structure and accountability in place.

Expecting the core team to take on tasks outside their mandate isn’t realistic, especially when their focus is guided by board-level decisions.


So… what can we actually do?

Looking at other ecosystems, what works best is creating an environment where — once an initiative like this is approved and funded — it can be delivered without blockers, and is fully supported and aligned with key stakeholders.

That means the community defines not only what’s needed, but also takes on the responsibility of executing the task properly — validating collaboration with the necessary parties.

To start moving in this direction, we should first:

  • Validate whether The Sandbox team sees the value in public APIs for third-party builders.
  • Confirm their openness to collaborating with external teams on execution.
  • Ensure a Technical Lead is assigned from The Sandbox — at least part-time — to act as a bridge between the external team and Sandbox. (If needed, the DAO can fund this role.)

From our experience, without these validations, proposals like this often generate initial excitement but ultimately lead to frustration when they can’t be delivered.

However, if we do secure the right support, we at WakeUp Labs are ready to co-develop a clear, actionable proposal with DAO contributors and lead the technical execution, if it gets approved.

3 Likes

Just a point of clarity on this…

The DAO does indeed exist to influence the direction of TSB’s ecosystem. Sometimes, that will inherently mean impact on their development roadmap and their current priorities.

All that said, THANK YOU for recognizing the hard word (and directives from all directions) that TSB devs must face. And thank you for clearly laying out the challenges being faced.

In this case, you’re right to raise a flag before the SIP idea is formalized through the curation process (so we can ensure it can be enacted if passed).


This is great input. Thank you also for inserting yourself in this API conversation, @Gonzacolo, as you’re experiencing the needs and limitations of existing access with your current DAO project.

When the conversation on this thread hones in on exactly what we should inquire with TSB about, @Cyril will absolutely ask the most appropriate people at TSB.

:red_question_mark: What do we want to ask TSB about APIs?

2 Likes

Just ideas, but it might be worth saying something like this:

The community has been asking for public APIs to build new projects and initiatives for quite some time now, and since it doesn’t seem possible to prioritize this internally, we thought about approaching it differently:

  • Does the Sandbox team see value in providing public APIs for third-party builders?
  • Is the Sandbox team open to collaborating with external teams on executing such initiatives?
  • Could a Technical Lead be assigned, even part time, to act as a point of contact between Sandbox and the external team? Would this be a role we should consider funding?

Other potential questions to ask:

  • What are the minimum requirements you envision for a proposed API intended for end users?
  • What are the minimum requirements for the teams that might be building these APIs?
  • Would it be helpful if we, as Sandbox DAO, pre-validate potential use cases? How much depth should we go into?
  • What format would you prefer for scoping discussions between both sides?
  • Would it make sense for Sandbox DAO to draft a list of key requests and baseline tasks that the API should cover?
2 Likes

I think voting makes it a priority, and recognizing it in this SIP Ideas subforum is the first step to making that happen.

It is if that’s what we decide as a SandFam that this is how we want our ecosystem to function. Our community refers to this as feature requests, and we’ve slowly evolved our community stance on this as something that’s acceptable to both the DAO and the Game’s Product Team. Reference SIPs 14, 16, and 21.

Instead, the DAO should focus on proposing initiatives that it can fully execute independently

I disagree that we are limited to only this. Our ecosystem is co-evolving with the Sandbox Game company.

I’m unsure if you realize…you are among fellow developers and studios. Most of us have previously pursued the three bullets you wrote.

2 Likes

The business side of opening an API is tricky because you are allowing data to be pulled from an database that costs you a lot to build and run. so unless you are sure it is a net positive you wouldn’t open it.

so in case of some of the game related data @cryptodiplo laid out, these are net positive as it enhances the overal user experience and giving the developer meaningful insights.

however I would be strongly against opening it more than necessary unless there is a free and paid options for it.

i.e. if you want to build an third party tool which stands on it’s own but wants to make use of the full API access, you do need to pay your share in SAND

I would like to know how other’s opinion is on it. Would we tie the access to land ownership, so you need your own land before you can ask for api access? is it unlimited or is it tiered pricing based on amount of your requests?
what other rules and incentives can be implemented to promote the usage of the API beyond a dozen studios and solodevelopers ?

4 Likes

UPDATE: API LIST

Most of this data is provided by the API. here I write the API ends you can use.

USER API
https://api.sandbox.game/users/username/(your TSB username)

for example
https://api.sandbox.game/users/username/biversen

or

https://api.sandbox.game/users/91d0d3f5-05d8-4139-8024-c0abc681b987

SOCIAL PROFILE INFO
https://api.sandbox.game/social/profile/37688f9c-5bb9-434a-a71a-2281d2620471 (Profie/userID)

INVENTORY
https://api.sandbox.game/assets/dashboard/inventory?creator=37688f9c-5bb9-434a-a71a-2281d2620471&userAddress=0x7a6597b5f2e66632f074368846e0df8b729f93cb&offset=0&published=true&sortBy=-created&filterType=assets&details=true&fromProfile=true&purchased=true

INVENTORY SALES
https://api.sandbox.game/assets/dashboard/inventory?page=1&limit=24&userAddress=0x7a6597b5f2e66632f074368846e0df8b729f93cb&sortBy=-created&details=true&fromProfile=true&sale=1&offset=0

INVENTORY PURCHASED
https://api.sandbox.game/assets/dashboard/inventory?page=1&limit=24&userAddress=0x7a6597b5f2e66632f074368846e0df8b729f93cb&sortBy=-created&details=true&fromProfile=true&purchased=1&offset=0

YOUR TOP EXPERIENCES
https://api.sandbox.game/lands/es/listExperiencesByIds?expIds[]=a780cef1-347a-4e6c-acd1-6194b3ecfef5&expIds[]=6e621b77-5be4-43da-8d88-f9437fe38524&expIds[]=8d802da3-11ba-4691-af16-6c4ccc2438ce

AVATARS DASHBOARD
https://api.sandbox.game/avatars/dashboard/user/37688f9c-5bb9-434a-a71a-2281d2620471




EXPERIENCES INFO
https://api.sandbox.game/lands/coordinates?coordinateX=128&coordinateY=-39&includeExperience=true&includeWallet=true

EXPERIENCE HUBS
https://api.sandbox.game/experiences/bb831f50-bc75-468d-b931-a2c9bbdf37a2/hubs/public

https://api.sandbox.game/hubs/65bac900-6596-47b2-a4ac-12f5f77302c5/experiences/2b90d025-f7f0-461e-b003-0ffad0fdc99f/pages/af681ee1-35fd-4bec-a2e1-f21a7b3c62cc

EXPERIENCE CATEGORY
https://api.sandbox.game/experience-categories/bb831f50-bc75-468d-b931-a2c9bbdf37a2

LEADERSBOARD
https://api.sandbox.game/ranking-results/bb831f50-bc75-468d-b931-a2c9bbdf37a2?includeAvatar=true&limit=100

COMMENTS
https://api.sandbox.game/experiences/bb831f50-bc75-468d-b931-a2c9bbdf37a2/comments?sort=DESC&offset=0&limit=15

EXPERIENCES ANALYTICS (DAILY INFO)
https://api.sandbox.game/experiences/7802ef51-16b4-41f9-97f3-bafdb3a8ed5d/analytics/daily-usage?sinceSkDate=20230110&untilSkDate=20250209

EXPERIENCES ANALYTICS (TOTAL INFO)
https://api.sandbox.game/experiences/7802ef51-16b4-41f9-97f3-bafdb3a8ed5d/analytics/total-usage




EXPERIENCES LIST
https://api.sandbox.game/lands/es/lands-experience-genres-paged?page=1&limit=15 (Change Page and Limit Number)

https://api.sandbox.game/lands/es/map-list/1?sortBy=featured (featured,trending,topRated,new)

EXPERIENCE IN CATEGORY LIST
https://api.sandbox.game/lands/es/map-list/1?sortBy=topRated&category=7&status[]=live&limit=500 (Change Category Number and Limit)

ALL CATEGORY / THEME GENRE LIST
https://api.sandbox.game/experience-categories/list

EXPERIENCE ON MAP INFO
https://api.sandbox.game/lands/coordinates?coordinateX=62&coordinateY=154&includeExperience=true&includeWallet=true




SOCIAL EVENT CATEGORIES
https://api.sandbox.game/social-events/categories

SOCIAL EVENT BANNER CONTENT
https://api.sandbox.game/social-events?bannerVisualization[]=events&priority=true&available=true&upcoming=true&past=true&limit=10&offset=0

SOCIAL EVENT PROGRESS
https://api.sandbox.game/social-events/list-progress?available=true&past=true&limit=10&offset=0

SOCIAL EVENT EXPERIENCE QUESTS INFO
https://api.sandbox.game/experiences/social-event/487/user-data?filter=all

Using these API ends, you can provide data to any page you make. These are the API ends used by the TSB official website.

Send requests to the system periodically instead of instantaneously, e.g. once a day for the analytics area or 15-20 minute intervals for the leaderboard.

The reason is that if you send too many requests to the system, it may detect you as an attack and block you.

6 Likes

Great comments @Gonzacolo thanks for the input. I’m generally in the camp of thinking that they just haven’t prioritized it because they are focusing on alpha seasons at the moment, and that is for good reason in that we don’t even have saved variables in the game maker so that should come first.

I do however think proposing a SIP and giving them a reasonable amount of time to execute on it will go a long way towards them prioritizing it, but that we should wait a bit to understand their implementation of saved variables before we do so so we can be more accurate. But I agree that the questions you’ve proposed will answer that definitively.

@SasanSeyedi.eth Fair point on the cost of an API. Frankly I would be fine with a paid API if that’s how it had to be done, I understand there are non negligible costs associated with it. Most APIs I work with are under 1 cent per call, so it wouldn’t scare developers off working with it and might add another revenue stream for the team.

3 Likes

Woah @Biversen this is amazing I didn’t even know this existed.

3 Likes