# Create a trading quote ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/quotes: post: summary: Create a trading quote deprecated: false description: '' operationId: createQuote tags: - REST API/Endpoints/Quotes - Quotes parameters: [] requestBody: content: application/json: schema: description: Request payload for creating a quote properties: assetId: type: string format: uuid description: Asset identifier (UUID) examples: - b86c034b-efe3-11eb-b56f-0691764446a7 currencyId: type: string format: uuid description: Currency identifier (UUID) examples: - b88b8466-efe3-11eb-b56f-0691764446a7 side: type: string description: Quote side (buy or sell) enum: - BUY - SELL examples: - buy quantity: type: string description: Defines quantity if asset amount needs to be provided pattern: ^([1-9]\d*(\.\d{1,8})?|0\.\d{0,7}[1-9])$ examples: - '0.1' notional: type: string description: Defines notional if currency amount need to be provided pattern: ^([1-9]\d*(\.\d{1,2})?|0\.\d{0,1}[1-9])$ examples: - '10' required: - assetId - currencyId - side x-apidog-orders: - assetId - currencyId - side - quantity - notional type: object responses: '200': description: Quote created successfully content: '*/*': schema: properties: data: properties: quoteId: type: string format: uuid status: type: string side: type: string enum: - BUY - SELL assetId: type: string format: uuid currencyId: type: string format: uuid quote: properties: price: type: string priceWithFee: type: string fee: type: string quantity: type: string notional: type: string expiresAt: type: string toEuroRate: type: string x-apidog-orders: - price - priceWithFee - fee - quantity - notional - expiresAt - toEuroRate type: object exAnte: description: >- Ex-ante cost transparency report, present only when a real security is traded properties: instrumentIsin: type: string description: ISIN of the underlying instrument examples: - US5949181045 costsAndCharges: description: >- Breakdown of all costs and charges applied to the trade properties: breakdown: type: array items: description: A single cost line item properties: type: type: string description: >- Cost category, e.g. service_cost, product_cost, inducement_cost amount: type: string description: Cost amount in the quote currency investmentPercent: type: string description: Cost as a percentage of the investment x-apidog-orders: - type - amount - investmentPercent type: object totalCosts: description: Sum of all cost line items properties: amount: type: string investmentPercent: type: string x-apidog-orders: - amount - investmentPercent type: object x-apidog-orders: - breakdown - totalCosts type: object impactOnPerformance: description: Effect of total costs on expected performance properties: netInvestmentAfterCosts: type: string netAmountAfterCosts: type: string estimatedReductionInReturnPercent: type: string illustration: description: >- Worked example of the cost impact on an assumed return properties: annual: type: string description: Assumed gross annual return percentage reduced: type: string description: Return percentage after costs x-apidog-orders: - annual - reduced type: object x-apidog-orders: - netInvestmentAfterCosts - netAmountAfterCosts - estimatedReductionInReturnPercent - illustration type: object cumulativeCosts: type: array items: description: >- Estimated costs accumulated over a given holding period properties: holdingPeriod: type: string description: >- Holding period, e.g. one_year, two_years, year_of_sale estimatedCosts: type: string returnsPercentPerAnnum: type: string x-apidog-orders: - holdingPeriod - estimatedCosts - returnsPercentPerAnnum type: object x-apidog-orders: - instrumentIsin - costsAndCharges - impactOnPerformance - cumulativeCosts type: object keyInformationDocuments: type: array description: >- Key Information Documents (KID) for the instrument; present only when an equity ETF/ETC is traded. CRITICAL: Always show the relevant KID link to the user if present. items: description: >- A Key Information Document (KID/PRIIPs KID) for the traded instrument, per country and language properties: country: type: string description: ISO country code the document applies to examples: - AT language: type: string description: ISO language code of the document examples: - de url: type: string description: Download URL of the Key Information Document x-apidog-orders: - country - language - url type: object warnings: type: array items: properties: code: type: string message: type: string x-apidog-orders: - code - message type: object tradingBudget: description: >- Current trading budget status. Null fields indicate no limit is configured. properties: buyBudgetRemaining: type: number description: Remaining buy budget for today sellBudgetRemaining: type: number description: Remaining sell budget for today limitCurrencyId: type: string format: uuid description: Currency UUID in which limits are denominated x-apidog-orders: - buyBudgetRemaining - sellBudgetRemaining - limitCurrencyId type: object x-apidog-orders: - quoteId - status - side - assetId - currencyId - quote - exAnte - keyInformationDocuments - warnings - tradingBudget type: object x-apidog-orders: - data type: object headers: {} x-apidog-name: OK '400': description: Invalid request parameters content: '*/*': schema: type: object properties: error: type: object properties: code: type: string x-apidog-orders: - code x-apidog-orders: - error headers: {} x-apidog-name: Parameter Error '422': description: Upstream rejected the offer request content: '*/*': schema: type: object properties: error: type: object properties: code: type: string x-apidog-orders: - code x-apidog-orders: - error headers: {} x-apidog-name: '' '500': description: Internal server error content: '*/*': schema: type: object properties: error: type: object properties: code: type: string x-apidog-orders: - code x-apidog-orders: - error headers: {} x-apidog-name: '' security: - x-api-key: [] x-apidog: schemeGroups: - id: 5Owgug5Rt4hY34zKilAQn schemeIds: - x-api-key required: true use: id: 5Owgug5Rt4hY34zKilAQn scopes: 5Owgug5Rt4hY34zKilAQn: x-api-key: [] x-apidog-folder: REST API/Endpoints/Quotes x-apidog-status: released x-run-in-apidog: https://app.eu.apidog.com/web/project/365298/apis/api-4375763-run components: schemas: {} securitySchemes: x-api-key: type: apikey name: x-api-key in: header servers: - url: https://api.public.bitpanda.com description: Production security: [] ```