Build on lp.xyz
A versioned API for partner backends that need the same market, portfolio, quote, and unsigned transaction-building capabilities used by lp.xyz. Access is reviewed, scoped, rate-limited, and priced by agreement with the team.
How access works
- 1 · Account ID
- Sign in and copy your Account ID from Settings → API.
- 2 · Terms
- Send it to the team and agree limits, scopes, and pricing.
- 3 · Access
- We switch on access.
- 4 · Keys
- Create, name, rotate and revoke your own server-side keys in Settings → API.
Authentication and safety
Send the key in X-API-Key from your backend. Keys begin with lpx_live_, are shown once, and should be held in a server secret manager. Every response includes a request ID. Admitted calls include rate-limit headers; public metadata and early denials can omit them.
Transaction builders return unsigned payloads
Your wallet infrastructure remains the signer. Builders require an Idempotency-Key; identical retries return the same result for ten minutes. Check transaction freshness before signing a replay.
Example
curl 'https://api.lp.xyz/v1/tokens/search?q=USDC&chain=base' \ -H 'X-API-Key: lpx_live_…'
Complete terminal workflow
Follow the terminal integration guide for copyable read, quote, build and confirmation examples, amount units, signing requirements and error recovery. Download the terminal smoke and signing preparation example to verify your integration with your approved host and key. The OpenAPI document lists request fields and scopes.
Review the signing plan
Solana payloads retain partial signatures and blockhash validity. EVM fee plans use the verified LP.xyz fee router; approvals remain receipt-gated prerequisites. Your custody infrastructure handles authorization, simulation, gas budgets and nonce ordering.
Limits and usage
- Your negotiated requests-per-minute and burst limit apply globally across your keys.
- Every call is recorded per key; Settings → API shows the last 30 days.
- A 401 means the key is invalid or access is off. A 429 includes Retry-After.
Endpoint catalogue
- GET /v1/openapi.json
- OpenAPI document · public
- GET /v1/chains
- List supported chains · public
- GET /v1/tokens/search
- Search tokens · market:read
- GET /v1/tokens/{mint}
- Token profile · market:read
- GET /v1/tokens/{mint}/price
- Token price · market:read
- GET /v1/tokens/{mint}/history
- Token price history · market:read
- GET /v1/tokens/{mint}/stats
- Token market statistics · market:read
- GET /v1/tokens/{mint}/holders
- Token holders · market:read
- GET /v1/tokens/{mint}/trades
- Token trades · market:read
- GET /v1/tokens/{mint}/top-traders
- Token top traders · market:read
- GET /v1/markets/trending
- Trending tokens · market:read
- GET /v1/pools/hot
- Hot pools · market:read
- GET /v1/pools/new
- New pools · market:read
- GET /v1/pools/{pool}
- Pool details · market:read
- GET /v1/pools/{pool}/reserves
- Pool reserves · market:read
- GET /v1/pools/{pool}/bins
- Pool bins · market:read
- GET /v1/pools/{pool}/chart
- Pool chart · market:read
- GET /v1/pools/{pool}/audit
- Pool audit · market:read
- GET /v1/portfolio/{owner}/holdings
- Wallet holdings · portfolio:read
- GET /v1/portfolio/holdings
- Batch wallet holdings · portfolio:read
- GET /v1/portfolio/{owner}/positions
- LP positions · portfolio:read
- GET /v1/portfolio/positions
- Batch LP positions · portfolio:read
- GET /v1/quotes/swap
- Swap quote · quote:read
- POST /v1/quotes/bridge
- Bridge quote · quote:read
- GET /v1/transactions/{signature}/status
- Transaction status · quote:read
- POST /v1/build/swap
- Build swap transactions · tx:build
- POST /v1/build/bridge
- Build bridge transactions · tx:build
- POST /v1/build/transfer
- Build transfer transactions · tx:build
- POST /v1/build/lp/create
- Build LP create transactions · tx:build
- POST /v1/build/lp/add
- Build LP add transactions · tx:build
- POST /v1/build/lp/increase
- Build LP increase transactions · tx:build
- POST /v1/build/lp/remove
- Build LP remove transactions · tx:build
- POST /v1/build/lp/harvest
- Build LP harvest transactions · tx:build
- POST /v1/build/lp/compound
- Build LP compound transactions · tx:build
- POST /v1/build/lp/rebalance
- Build LP rebalance transactions · tx:build
- POST /v1/build/lp/migrate
- Build LP migrate transactions · tx:build
- POST /v1/build/lp/farm
- Build LP farm transactions · tx:build
- POST /v1/build/confirm
- Confirm a returned build · tx:build
Request access
Negotiated pricing and limits stay private so they can reflect your volume, endpoint mix, and upstream cost profile.
Request access from Settings → API, or contact the team.