bloxvalues APIbloxvalues.net ↗
Access live Blox Fruits dealer stock, community trade values, and Win/Fair/Lose trade calculations via the bloxvalues.net API. 3 endpoints, real-time data.
What is the bloxvalues API?
The bloxvalues.net API exposes 3 endpoints covering live Blox Fruits dealer inventories, community-sourced item trade values, and automatic trade analysis. The calculate_trade endpoint accepts two item lists and returns a Win, Fair, or Lose verdict with per-item breakdowns, while get_trade_values delivers rarity, demand rating, and trend data across every tracked item in the game.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1f2aaf94-15b4-46ba-8000-b91992c63397/get_dealer_stock' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace bloxvalues-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: BloxValues SDK — bounded, re-runnable; every call capped."""
from parse_apis.bloxvalues_net_api import BloxValues, Category, ValueType, InvalidInput
client = BloxValues()
# Fetch current dealer stock
stock = client.stocks.get()
print("Normal Dealer:")
for item in stock.normal_dealer[:3]:
print(f" {item.name} — ${item.price:,} / R{item.robux}")
print("Mirage Dealer:")
for item in stock.mirage_dealer[:3]:
print(f" {item.name} — ${item.price:,} / R{item.robux}")
# List top fruits by trade value
for fruit in client.items.list(category=Category.FRUITS, limit=3):
print(fruit.name, fruit.value, fruit.demand, fruit.trend)
# Calculate a trade
try:
trade = client.trades.calculate(
your_items="Buddha,Dough",
their_items="Kitsune",
value_type=ValueType.REGULAR,
)
print(trade.result, trade.difference)
print("Your total:", trade.your_offer.total_value)
print("Their total:", trade.their_offer.total_value)
except InvalidInput as e:
print("bad input:", e)
print("exercised: stocks.get / items.list / trades.calculate")
Returns the current live Normal and Mirage dealer fruit inventories. Stock rotates periodically. Each item includes its beli price and Robux cost.
No input parameters required.
{
"type": "object",
"fields": {
"mirage_dealer": "array of items currently in the Mirage dealer",
"normal_dealer": "array of items currently in the Normal dealer"
},
"sample": {
"data": {
"mirage_dealer": [
{
"name": "Flame",
"image": "https://bloxvalues.net/wp-content/uploads/2025/10/Flame.webp",
"price": 250000,
"robux": 550
},
{
"name": "Shadow",
"image": "https://bloxvalues.net/wp-content/uploads/2025/10/Shadow.webp",
"price": 2900000,
"robux": 2425
}
],
"normal_dealer": [
{
"name": "Rocket",
"image": "https://bloxvalues.net/wp-content/uploads/2025/10/Rocket.webp",
"price": 5000,
"robux": 50
},
{
"name": "Ice",
"image": "https://bloxvalues.net/wp-content/uploads/2025/10/Ice.webp",
"price": 350000,
"robux": 750
}
]
},
"status": "success"
}
}About the bloxvalues API
Dealer Stock and Item Values
The get_dealer_stock endpoint returns the current inventories of both the Normal and Mirage fruit dealers. Each item in the response includes its beli price and Robux cost. Stock rotates on the source site's schedule, so repeated calls reflect the current active rotation without any additional parameters.
The get_trade_values endpoint returns every tracked Blox Fruits item with its community-agreed trade value (both regular and permanent variants), rarity classification, demand rating, trend direction, and category. Passing the optional category parameter narrows results to a single item type — for example, fruits, swords, or accessories. The total field in the response tells you how many items matched the filter.
Trade Calculation
The calculate_trade endpoint takes two comma-separated item lists — your_items and their_items — and returns a structured verdict. You can specify quantities using the name:qty format (e.g. Buddha:2). The optional value_type parameter controls whether regular or permanent values are used in the comparison. The response includes your_offer and their_offer objects, each with an items array and a total_value, plus a difference field showing the numeric gap. Trades within 10% of each other in value return Fair; anything outside that threshold returns Win or Lose.
The bloxvalues API is a managed, monitored endpoint for bloxvalues.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bloxvalues.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official bloxvalues.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a trade assistant bot that flags unfair trades before a player accepts, using calculate_trade verdicts and difference values.
- Display live dealer fruit availability in a game companion app, pulling beli and Robux prices from get_dealer_stock.
- Create an item tier list sorted by demand rating and trend from get_trade_values.
- Alert users when a specific high-rarity fruit appears in the Mirage dealer by polling get_dealer_stock.
- Build a portfolio tracker showing total permanent value of a player's item collection using perm values from get_trade_values.
- Filter and display category-specific item values (e.g. only swords) for a focused price guide using the category parameter.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does bloxvalues.net offer an official developer API?+
What does calculate_trade return beyond a Win/Fair/Lose verdict?+
result field (Win, Fair, or Lose), a numeric difference showing their_total minus your_total, the value_type used in the calculation, and separate your_offer and their_offer objects. Each offer object contains an items array with per-item values, demand, and trend, plus a total_value for that side.How current is the dealer stock data?+
get_dealer_stock endpoint reflects the live rotation as shown on bloxvalues.net. Dealer stock on Blox Fruits rotates on a fixed in-game schedule, so the data is only as fresh as the source site's last update. For time-sensitive use cases, polling at a reasonable interval is recommended.Can I look up trade values for a specific item by name, or search across items?+
get_trade_values endpoint supports filtering by category, but not by individual item name. It returns all items matching that category, and you apply name-based filtering client-side from the returned array. You can fork this API on Parse and revise it to add a name-based search or lookup endpoint.