vertex

Trade spot, perpetuals, and money markets on Vertex Protocol via its Python SDK and APIs.

1|1|Updated May 21, 2026
One-click install
npx skills add https://github.com/naruto11eth/cryptoskills --skill vertex-naruto11eth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vertex
Source: https://github.com/naruto11eth/cryptoskills/tree/main/skills/vertex
Command: npx skills add https://github.com/naruto11eth/cryptoskills --skill vertex-naruto11eth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? LLMs have stale knowledge of Vertex Protocol — wrong product IDs, incorrect package names, and misunderstood x18 fixed-point math — causing failed orders, invalid signatures, and lost funds when integrating with this cross-chain DEX. ## Core Features & Use Cases - Order Execution: Place, cancel, and atomically replace spot and perpetual orders with correct EIP-712 signing, x18 price encoding, and timestamp-based nonces. - Cross-Chain Trading: Use Vertex Edge unified liquidity across Arbitrum, Base, Mantle, Sei, Blast, and Sonic with per-chain gateway, indexer, and trigger endpoints. - Money Markets & Margin: Deposit collateral, earn lending interest implicitly, borrow via negative spot balances, and monitor cross-margin health. - Real-Time & Historical Data: Stream orderbook, trade, and fill data over WebSocket subscriptions and query the indexer for fills, funding rates, and candlesticks. - Use Case: Build a trading bot that opens a leveraged BTC-PERP long with an IOC order, attaches a stop-loss via the trigger API, and streams fill notifications for its subaccount. ## Quick Start Install the vertex-protocol Python package and ask the agent to place a limit order on Vertex using the correct product ID and x18 price encoding.

Frequently Asked Questions about vertex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place an order on Vertex Protocol with Python?

Install the vertex-protocol package, create a client with create_vertex_client and your private key, then build an OrderParams with priceX18 via to_x18(), a signed amount, an expiration from get_expiration_timestamp(), and a nonce from gen_order_nonce(). Submit it with client.market.place_order.

How do Vertex product IDs work for spot and perpetual markets?

Product ID 0 is USDC, the quote asset. Odd IDs are spot markets (1=wBTC, 3=wETH) and even IDs are perpetuals (2=BTC-PERP, 4=ETH-PERP). Availability varies by chain, so query all_products on the target gateway before trading.

Which chains does Vertex Edge support for cross-chain trading?

Vertex Edge unifies orderbook liquidity across Arbitrum, Base, Mantle, Sei, Blast, and Sonic. Orders match cross-chain at the sequencer level and settle on each user's origin chain, with separate gateway endpoints per chain.

Why does my Vertex order fail with invalid nonce or invalid signature?

Invalid nonce occurs when using sequential integers instead of the timestamp-based gen_order_nonce(). Invalid signature usually means the private key mismatches the subaccount owner, the wrong chain ID is used, or the sender bytes32 was not built with subaccount_to_bytes32().

How does lending and borrowing work on Vertex money markets?

Lending and borrowing are implicit with no separate actions. Any positive spot balance automatically earns deposit interest, while a negative spot balance from selling unheld assets incurs the borrow rate, all within one cross-margin health calculation.

How do I stream real-time orderbook and fill data from Vertex?

Connect to the subscriptions WebSocket endpoint at /v1/subscribe and send subscribe messages with stream types like best_bid_offer, trade, book_depth, fill, position_change, or order_update. Authenticated streams require your subaccount as a bytes32 hex string.