OpenAPI Spec & Postman Collection
The full XRPL Request API is described as an OpenAPI 3.0 document and a Postman collection for easy testing and code generation.
OpenAPI spec
The spec is served directly from the app:
https://xrplre.quest/openapi.yamlIt covers all 12 API endpoints with full request/response schemas, error responses, enum values, and authentication requirements.
Use with code generators
# Generate a typed client with openapi-typescript
npx openapi-typescript https://xrplre.quest/openapi.yaml -o xrpl-request.d.ts
# Generate a Python client with openapi-generator
openapi-generator-cli generate \
-i https://xrplre.quest/openapi.yaml \
-g python \
-o ./xrpl-request-client
# Generate a Go client
openapi-generator-cli generate \
-i https://xrplre.quest/openapi.yaml \
-g go \
-o ./xrpl-request-clientEndpoints covered
| Method | Path | Description |
|---|---|---|
POST | /api/v1/payloads | Create a signing payload |
GET | /api/v1/payloads | List payloads |
GET | /api/v1/payloads/{uuid} | Get payload status |
DELETE | /api/v1/payloads/{uuid} | Cancel a pending payload |
POST | /api/v1/webhooks | Register a webhook |
GET | /api/v1/webhooks | List webhooks |
DELETE | /api/v1/webhooks/{id} | Remove a webhook |
POST | /api/v1/projects | Create a project |
GET | /api/v1/projects/{id}/keys | List API keys |
POST | /api/v1/projects/{id}/keys | Create an API key |
DELETE | /api/v1/projects/{id}/keys/{keyId} | Revoke an API key |
GET | /api/v1/projects/{id}/analytics | Usage analytics |
Postman collection
Download and import the collection into Postman:
https://raw.githubusercontent.com/LedgerCraft/XRPL-Request/main/postman_collection.jsonOr clone the repo and import postman_collection.json directly.
Quick start with Postman
- Import the collection
- Set the
apiKeycollection variable to yourxrplr_live_...key - Run Create payload (signAndSubmit) — the
payloadUuidvariable is set automatically - Open
signingUrlin a browser and sign with any wallet - Run Get payload to see the resolved status and
txHash
💡
The collection includes pre-request scripts that automatically save payloadUuid, webhookId, and projectId to collection variables after creation, so subsequent requests work without manual copy-paste.