vertex

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires vertex-protocol, websocket-client, requests, python-dotenv, and includes references (resource) components.

What problem does it solve? LLMs have stale knowledge about Vertex Protocol — wrong product IDs, incorrect package names, and misunderstood x18 fixed-point math — leading to failed orders, invalid signatures, and lost funds when building trading integrations. ## Core Features & Use Cases - Order Execution: Place, cancel, and atomically replace spot and perpetual orders with correct EIP-712 signing, timestamp-based nonces, and x18 fixed-point encoding. - Cross-Chain Trading: Use Vertex Edge to trade unified orderbook liquidity across Arbitrum, Base, Mantle, Sei, Blast, and Sonic with gas-free sequencer settlement. - Money Markets & Margin: Deposit collateral, earn lending interest automatically, borrow implicitly 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 Python trading bot that opens a leveraged BTC-PERP position with an IOC order, attaches a stop-loss via the trigger API, and streams fill notifications over WebSocket. ## Quick Start Install the vertex-protocol Python package and use this skill to place a limit order on Vertex with correct signing and product IDs.

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 perp 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). Spot and perp pairs share a health group for cross-margin calculations.

Why does Vertex reject my order with an invalid nonce error?

Vertex nonces are timestamp-based, not sequential counters. Using sequential integers causes rejection. Always generate nonces with gen_order_nonce() from the SDK and never reuse a nonce across orders.

Does Vertex Protocol support chains other than Arbitrum?

Yes. 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 chain-specific gateway endpoints.

Why is my Vertex order signature invalid?

The sender field must be a bytes32 combining the 20-byte address with a 12-byte subaccount name, and the EIP-712 domain chain ID must match the target chain. Use subaccount_to_bytes32() and the correct VertexClientMode for your chain.

How does lending and borrowing work on Vertex?

There are no separate lend or borrow actions. Positive spot balances automatically earn deposit interest, and negative spot balances from selling assets you do not hold implicitly borrow at the prevailing rate, subject to cross-margin health.