{"openapi":"3.1.0","info":{"title":"Perp DEX costs & funding — Dinero en la Mesa","version":"1.0.0","description":"Same tools as the MCP server at https://dineroenlamesa.com/agents/mcp, over plain HTTP GET. Free, read-only, no key.","termsOfService":"https://dineroenlamesa.com/agents/terms/","license":{"name":"Data by Dinero en la Mesa, under its terms of use","url":"https://dineroenlamesa.com/agents/terms/"}},"servers":[{"url":"https://dineroenlamesa.com"}],"paths":{"/agents/api/best_venue":{"get":{"operationId":"best_venue","summary":"Cheapest perp DEX for a trade","description":"Which decentralised perpetual exchange is cheapest right now to open and close a market order of a given size: taker fees on both legs plus real slippage on the live order book, across 28 perp DEXs (Hyperliquid, Lighter, Aster, Extended, Paradex…). Every figure with its time and source.","parameters":[{"name":"pair","in":"query","required":true,"description":"Base asset of the perpetual, e.g. BTC","schema":{"type":"string","enum":["BTC","ETH","SOL","XRP","BNB","DOGE","HYPE","SUI","LINK","AAVE","ENA","LTC"]}},{"name":"size_usd","in":"query","required":true,"description":"Order size in USD (notional)","schema":{"type":"number","minimum":10}},{"name":"monthly_volume_usd","in":"query","required":false,"description":"Your 30-day trading volume in USD, to pick your fee tier (default 0)","schema":{"type":"number","minimum":0}}],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/trading_cost":{"get":{"operationId":"trading_cost","summary":"All-in trading cost on every perp DEX","description":"Full ranking of the round-trip cost (fees + slippage on the live book) of a market order on each perp DEX, with fee tier, book time and the venues that give no figure and why.","parameters":[{"name":"pair","in":"query","required":true,"description":"Base asset of the perpetual, e.g. BTC","schema":{"type":"string","enum":["BTC","ETH","SOL","XRP","BNB","DOGE","HYPE","SUI","LINK","AAVE","ENA","LTC"]}},{"name":"size_usd","in":"query","required":true,"description":"Order size in USD (notional)","schema":{"type":"number","minimum":10}},{"name":"monthly_volume_usd","in":"query","required":false,"description":"Your 30-day trading volume in USD, to pick your fee tier (default 0)","schema":{"type":"number","minimum":0}}],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/funding_rates":{"get":{"operationId":"funding_rates","summary":"Funding rates across perp DEXs","description":"Current funding rate of a perpetual on each perp DEX, normalised to 8 hours and annualised, with open interest and 24h volume when published. Useful for delta-neutral funding trades.","parameters":[{"name":"pair","in":"query","required":true,"description":"Base asset of the perpetual, e.g. BTC","schema":{"type":"string","enum":["BTC","ETH","SOL","XRP","BNB","DOGE","HYPE","SUI","LINK","AAVE","ENA","LTC"]}}],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/depth":{"get":{"operationId":"depth","summary":"Order book depth and spread on every perp DEX","description":"Best bid/ask, spread in bps and the USD resting within 0.5% and 1% of mid on each side, for every live perp DEX order book.","parameters":[{"name":"pair","in":"query","required":true,"description":"Base asset of the perpetual, e.g. BTC","schema":{"type":"string","enum":["BTC","ETH","SOL","XRP","BNB","DOGE","HYPE","SUI","LINK","AAVE","ENA","LTC"]}}],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/delta_neutral":{"get":{"operationId":"delta_neutral","summary":"Best delta-neutral funding pair, net of costs","description":"The best long/short pair across perp DEXs to collect the funding difference on one pair, net of opening and closing both legs at market. Free tier: a reading up to 15 minutes old. Rates change every hour: a snapshot, not a forecast.","parameters":[{"name":"pair","in":"query","required":true,"description":"Base asset of the perpetual, e.g. BTC","schema":{"type":"string","enum":["BTC","ETH","SOL","XRP","BNB","DOGE","HYPE","SUI","LINK","AAVE","ENA","LTC"]}},{"name":"size_usd_per_leg","in":"query","required":false,"description":"USD per leg (default 10000)","schema":{"type":"number","minimum":100}},{"name":"days","in":"query","required":false,"description":"Holding days (default 7)","schema":{"type":"number","minimum":1,"maximum":90}}],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/cost_per_point":{"get":{"operationId":"cost_per_point","summary":"Airdrop points per dollar of fees, this week","description":"For perp DEXs with a published weekly points pool: points your volume would earn this week and what it costs in fees. A theoretical maximum, said so.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/live_airdrops":{"get":{"operationId":"live_airdrops","summary":"Open airdrop and points campaigns","description":"Airdrop and points campaigns we track, ordered by the next hard date, each date from the project’s own docs, with the signup link.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/changes":{"get":{"operationId":"changes","summary":"What changed in tracked airdrops","description":"Changes in the airdrops we track (dates, rules, rewards) in the last 1 to 7 days, newest first.","parameters":[{"name":"days","in":"query","required":false,"description":"Look-back in days (default 1)","schema":{"type":"integer","minimum":1,"maximum":7}}],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/list_venues":{"get":{"operationId":"list_venues","summary":"Perp DEXs covered","description":"The perp DEXs we cover: order book type, entry-tier maker/taker fees verified in each venue's docs, the date they were checked, and the signup link.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/delta_neutral_scanner":{"get":{"operationId":"delta_neutral_scanner","summary":"Delta neutral scanner (Pro, coming soon)","description":"COMING SOON, Pro (0.10 USD per scan, USDC via x402). Every pair and every venue couple, every minute, net of opening and closing both legs on the real books, with how long each gap usually lasts. Calling it now returns its status and the free tool to use meanwhile.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/farming_route":{"get":{"operationId":"farming_route","summary":"Farming route (Pro, coming soon)","description":"COMING SOON, Pro (0.25 USD per route, USDC via x402). Where and how to trade to earn the most airdrop points per dollar of fees for your capital and horizon, avoiding what each campaign penalises. Calling it now returns its status and the free tool to use meanwhile.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/execution_plan":{"get":{"operationId":"execution_plan","summary":"Execution plan (Pro, coming soon)","description":"COMING SOON, Pro (0.05 USD per plan, USDC via x402). How to split a large order across venues so each book only absorbs what it can, paying less slippage. Calling it now returns its status and the free tool to use meanwhile.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/history":{"get":{"operationId":"history","summary":"History (Pro, coming soon)","description":"COMING SOON, Pro (0.05 USD per series, USDC via x402). Funding, costs and order books as we read them, venue by venue, to backtest a strategy. Calling it now returns its status and the free tool to use meanwhile.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/alerts":{"get":{"operationId":"alerts","summary":"Alerts (Pro, coming soon)","description":"COMING SOON, Pro (29 USD per month for 3 pairs, 79 USD unlimited, USDC via x402). A webhook to your agent the minute a net funding gap or a cost crosses the threshold you set. Calling it now returns its status and the free tool to use meanwhile.","parameters":[],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}},"/agents/api/signup_link":{"get":{"operationId":"signup_link","summary":"Account opening link for a perp DEX","description":"Link to open an account on a perp DEX, with our referral applied when we have one.","parameters":[{"name":"venue","in":"query","required":true,"description":"Venue id from list_venues, e.g. hyperliquid","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON with every figure, its time and its state"},"400":{"description":"Invalid arguments"},"429":{"description":"Rate limit"},"503":{"description":"Busy: retry in a few seconds"}}}}}}