FX RFQ Pricing Service Code Catalogue

The FX RFQ (Request for Quote) Pricing Service provides a robust solution for developers to request and manage foreign exchange (FX) quotes and deals. This API enables seamless integration with ANZ’s FX trading platform, allowing businesses to obtain real-time FX rates, execute trades, and manage the lifecycle of FX deals programmatically.

Capabilities:

  • Asynchronous Quote Requests: Submit requests for FX quotes asynchronously, allowing for efficient handling of high-volume trading scenarios without blocking your application workflow.

  • Real-Time Quote Polling: Poll the API to retrieve the status and details of submitted quotes, providing up-to-date information on FX rates and market conditions.

  • Deal Execution: Convert accepted quotes into confirmed FX deals by submitting requests through the API, facilitating automated trading and transaction management.

  • Quote and Deal Management: Use the API to decline or cancel issued quotes, providing flexibility in managing your FX trading strategy.

Technical Requirements:

  • Authentication: Requires OAuth 2.0 authentication with a bearer token obtained via the Client Credential Grant flow. API requests must include this token in the authorisation header as Bearer <access_token>.

  • Endpoints:

    • Quote Submission: POST /fx/v1.0/quotes/{country-code} - Submit a new FX quote request.

    • Quote Polling: GET /fx/v1.0/quotes/{quoteIdentifier} - Poll for the status of a submitted quote.

    • Deal Submission: POST /fx/v1.0/deals/{quoteIdentifier} - Submit a request to execute a deal based on an accepted quote.

    • Quote Cancellation: PUT /fx/v1.0/quotes - Cancel or decline a specific quote.

    • Payloads and Responses: API interactions use JSON payloads for requests and responses, supporting structured and consistent data exchange.

Key Features for Developers:

  • Seamless Integration: Easily integrate FX trading capabilities into your applications with RESTful APIs, enabling real-time FX rate retrieval and deal execution.

  • Flexibility: Manage the complete FX trading lifecycle from quote requests to deal management, allowing for automated trading strategies and improved operational efficiency.

  • Error Handling: Comprehensive error codes and detailed response messages help developers troubleshoot issues quickly and ensure reliable integration.

  • Security: All API requests are secured using OAuth 2.0 and HTTPS, ensuring that sensitive financial transactions are protected.

Example Use Cases:

  • Automated Trading Systems: Incorporate FX RFQ and deal execution into your trading algorithms to automate FX transactions based on predefined strategies.

  • Real-Time Pricing Applications: Use the service to fetch real-time FX rates, providing users with up-to-date pricing information for currency conversion or financial analysis.

  • Treasury Management: Integrate the FX RFQ Pricing Service into treasury systems to streamline FX deal management, helping organizations manage their currency exposure and liquidity effectively.

Example Request:

POST /fx/v1.0/quotes/NZ HTTP/1.1
Host: api.fileactive.anzgcis.com
Content-Type: application/json
authorisation: Bearer <access_token>

{
  "customerExternalIdentifier": "CRN0000000001",
  "channelTransactionIdentifier": "0123456789",
  "currencyPair": "AUD/USD",
  "parentDealSourceSystem": "ABCDEF",
  "parentDealId": "123456789",
  "auxiliaryType": "HR_EXT",
  "requestLegs": [{}]
}