🪐 Jupiter Perps Stats Scraper

🚀 Export Jupiter Perps Solana position stats, leverage, and PnL in seconds.

🕒 Last updated 2026-06-05 · 📊 11 fields per record · Jupiter Perps · Solana · live open positions

The Jupiter Perps Stats Scraper turns the public https://perps-api.jup.ag/v1/positions endpoint into a clean, structured dataset. It calls the upstream service, normalizes the response, and emits one flat record per entity.

🎯 Target Audience	💡 Primary Use Cases
📊 Analysts	Build clean snapshots of Jupiter Perps Solana positions and stats
🤖 ML engineers	Training datasets without writing client code
🏢 Research teams	Periodic monitoring and dashboards
👩‍💻 Developers	Mirror upstream data into your own warehouse

📋 What this scraper does

• Calls https://perps-api.jup.ag/v1/positions with your filters.
• Parses the response and flattens each entity into a row.
• Surfaces any upstream rate-limit or error notes as a clean error record instead of crashing.
• Pushes records to the Apify dataset ready for download or downstream integration.

💡 Why it matters the upstream API is public but returns nested payloads. This actor normalizes everything to a flat schema your tools can use immediately.

🎬 Full Demo

🚧 Coming soon.

⚙️ Input

Field	Type	Required	Description
side	enum	No	Filter by long or short positions only.
market	string	No	Optional market filter such as SOL-PERP.
maxItems	integer	No	Free users 10. Paid users up to 1,000,000. Prefill 10.

Example

{
  "maxItems": 10
}

⚠️ Good to Know the actor enforces a 10 item preview limit for free users and auto-warns with an upgrade link. Paid users can request up to 1,000,000 items per run.

📊 Output

Each record is a flat object. error is always last.

Field	Type	Description
🔹 wallet	string	Position owner wallet address.
🔹 market	string	Market identifier.
🔹 side	string	Long or short side.
🔹 sizeUsd	number	Position size in USD.
🔹 collateral	number	Collateral amount.
🔹 leverage	number	Effective leverage.
🔹 entryPrice	number	Entry price.
🔹 liquidationPrice	number	Liquidation price.
🔹 pnl	number	Unrealized PnL.
🔹 fundingPaid	number	Funding paid since open.
🔹 scrapedAt	string	When this row was fetched.
❌ error	string	Set if the upstream response was an error or rate-limit.

Sample record

{
  "wallet": "ABCxyz",
  "market": "SOL-PERP",
  "side": "long",
  "sizeUsd": 5000,
  "collateral": 500,
  "leverage": 10,
  "entryPrice": 155.2,
  "liquidationPrice": 142.8,
  "pnl": 12.4,
  "fundingPaid": 0.3,
  "scrapedAt": "2026-06-05T12:00:00.000Z",
  "error": null
}

✨ Why choose this Actor

| 🆓 | Works with the public endpoint, no signup required for most queries. | | 🧹 | Flat normalized schema, no nested keys to wrangle. | | 🛟 | Surfaces upstream errors as clean records instead of crashing. | | 💾 | Push to dataset, instant export to your favorite format. |

📈 How it compares to alternatives

Approach	Setup time	Clean keys	Error handling
Roll your own fetch	30 min plus	No	No
This Actor	5 sec, no install	Yes	Yes

🚀 How to use

1. Click Try for free.
2. Set your filters or leave defaults.
3. Click Start. Within seconds your dataset is ready.

💼 Business use cases

📊 Market research. Snapshot the dataset on a schedule and pipe into your BI tool.

💼 Analytics. Track changes across runs to build trend reports.

📰 Reporting. Verify upstream metrics with one click instead of writing custom client code.

🤖 ML feature engineering. Build a clean training set without provisioning any infra.

🔌 Automating this Actor

• Make and Zapier trigger this actor on a schedule, push results to Airtable, Google Sheets, or Slack.
• Cron schedule native Apify scheduler.
• Webhooks get a POST to your endpoint the moment a run finishes.
• Warehouse pipes native Apify integrations move datasets straight into your warehouse.

🌟 Beyond business use cases

🎓 Education. Teach a class with real public data.

🧪 Personal research. Track topics you care about.

🤝 Non-profit and open data. Build public dashboards without writing client code.

🧰 Tinkering and prototyping. Spin up a feed in 5 seconds to test a new tool.

🤖 Ask an AI assistant about this scraper

Pop this README into ChatGPT, Claude, or any AI assistant and ask it to map your specific workflow to the actor's inputs.

❓ Frequently Asked Questions

❓ Do I need an API key? Not for most queries. The upstream endpoint is public.

❓ Is there a rate limit? The upstream service applies its own limits. This actor surfaces rate-limit notes as a clean error record.

❓ Can I schedule runs? Yes, use Apify's native scheduler.

❓ How fresh is the data? It is fetched live on every run.

❓ Will the schema change? The documented fields are stable. Optional fields may appear based on upstream changes.

🔌 Integrate with any app

Apify ships native integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, and any REST API or webhook endpoint.

🔗 Recommended Actors

Actor	What it does
ParseForge Alpha Vantage Scraper	Stocks, FX, crypto, and indicators.
ParseForge OurAirports Scraper	Global airport database.
ParseForge Yahoo Finance Scraper	Equities, funds, indices.

💡 Pro Tip browse the complete ParseForge collection for 900 plus production-grade scrapers across business intelligence, real estate, e-commerce, sports, finance, and public records.

---

Disclaimer This actor scrapes only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by any of the third-party services referenced. Users are responsible for complying with the target site's terms of service and applicable law. Create a free account w/ $5 credit.