grapl API
Use indexed pool discovery, native direct-pool quotes, and transaction observation as separate services.
The SDK's direct client works with RPC and a wallet integration. The HTTP API is an optional service for indexed discovery, quoting, and transaction observation; it is not a required signing or settlement layer.
No public service origin or general API-key onboarding is announced here. The source API's OpenAPI documents are served by its configured deployment. Do not infer an API hostname from the documentation hostname.
Authentication and limits
Use integration keys and inspect shared request capacity.
Pool discovery
Find pools by mint and paginate the catalog.
Direct-pool quotes
Compare complete ExactIn and ExactOut results.
Status streams
Poll outcomes or consume resumable SSE events.
API Reference
Browse the generated public OpenAPI contract.
Public trading surface
| Resource | Current purpose |
|---|---|
GET /v1/pools | Discover indexed pools by mint, with optional quote mint and cursor pagination |
GET /v1/swap/quote | Compare eligible direct pools for an ExactIn or ExactOut amount |
| Transaction status resources | Observe indexed finalized or failed results and stream updates |
Quotes compare complete executable input/output, including fees, price movement, and available liquidity. They do not simply choose the lowest percentage fee. A catalog entry does not guarantee sufficient liquidity or hook-aware quotability.
Current boundaries
The HTTP quote path uses the native Rust engine for direct-pool candidates. Multihop and split routing are not implemented. The HTTP bridge does not currently supply hook adapters; it rejects unsupported policies. priceImpactPct: null means that metric is unavailable, not zero price impact.
Build, order, and submit resources are not connected to a trading gateway and currently reject with service-unavailable responses. SDK execution and API observation are separate flows. The API cannot sign for a user's wallet.
For native router integration, read Metis. For the protocol's stable on-chain interfaces, use Instructions and Accounts. Team administration and internal service operations are outside this public guide.