# PublicMarketData
## getFinancialInstruments
> Anonymous endpoint that lists all financial instruments available for primary market trading
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"FinancialInstrumentFilterCriteria":{"type":"object","properties":{"primaryMarket":{"type":"boolean"},"secondaryMarket":{"type":"boolean"}}},"FinancialInstrumentTableBaseWithId":{"type":"object","properties":{"symbol":{"description":"The financial instrument's symbol\n","type":"string","maxLength":255},"fullName":{"description":"The financial instrument's name\n","type":"string","maxLength":255},"status":{"description":"Trading status of the financial instrument\n","$ref":"#/components/schemas/FinancialInstrumentStatusEnum","readOnly":true},"isin":{"description":"International Securities Identification Number (ISIN) of the financial instrument\n","type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"dti":{"description":"Digital Token Identifier (DTI) of the financial instrument\n","type":"string","maxLength":255},"issuerName":{"description":"Name of the issuer of the financial instrument\n","type":"string","maxLength":255},"prospectusLink":{"description":"Link to further information about the financial instrument\n","type":"string","readOnly":true,"maxLength":255},"effectiveDate":{"description":"First day of active trading on 21X\n","type":"string","format":"date-time"},"terminationDate":{"description":"Last day of trading on 21X\n","type":"string","format":"date-time"},"smartContractAddress":{"description":"The blockchain address of the financial instrument's smart contract\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"internalId":{"type":"string","readOnly":true,"maxLength":255}}},"FinancialInstrumentStatusEnum":{"type":"string","enum":["CREATED","APPROVED","ACTIVE","EXPIRED","DEACTIVATED"]},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/financialinstruments":{"get":{"tags":["PublicMarketData"],"summary":"getFinancialInstruments","description":"Anonymous endpoint that lists all financial instruments available for primary market trading\n","operationId":"getFinancialInstruments","parameters":[{"name":"query","in":"query","required":false,"schema":{"$ref":"#/components/schemas/FinancialInstrumentFilterCriteria"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentTableBaseWithId"}}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getFinancialInstrument
> Anonymous endpoint that returns extended information on a financial instrument
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"FinancialInstrumentPublic":{"required":["fullName"],"type":"object","properties":{"status":{"$ref":"#/components/schemas/FinancialInstrumentStatusEnum","readOnly":true,"default":"CREATED"},"domicile":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":255},"wkn":{"type":"string","maxLength":6},"sedol":{"type":"string","maxLength":7},"cusip":{"type":"string","maxLength":9},"valor":{"type":"string","maxLength":50},"dti":{"type":"string","maxLength":9},"symbol":{"type":"string","maxLength":10},"protocol":{"$ref":"#/components/schemas/BlockChainEnum"},"smartContractAddress":{"type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"isin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"fullName":{"type":"string","maxLength":255},"cfi":{"type":"string","pattern":"^[A-Z]{6}$","maxLength":255},"commoditiesDerivativeIndicator":{"type":"boolean","default":false},"issuerId":{"type":"string","maxLength":255},"issuerName":{"type":"string","maxLength":255},"tradingVenue":{"type":"string","maxLength":4,"default":"21XX"},"fisn":{"type":"string","maxLength":35},"issuerRequestForAdmissionToTrade":{"type":"boolean","default":false},"listingDate":{"type":"string","format":"date"},"issuerApprovalDate":{"type":"string","format":"date-time"},"admissionToTradeRequestDate":{"type":"string","format":"date-time"},"effectiveDate":{"type":"string","format":"date-time"},"terminationDate":{"type":"string","format":"date-time"},"notionalCurrency1":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255,"default":"EUR"},"mifirIdentifier":{"$ref":"#/components/schemas/MifirIdentifierEnum"},"numberOfOutstandingInstruments":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"holdingsExceedingTotalVotingRightThreshold":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"issuanceSize":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"assetClassOfUnderlying":{"$ref":"#/components/schemas/AssetClassOfUnderlyingEnum"},"maturityDate":{"type":"string","format":"date"},"contractType":{"$ref":"#/components/schemas/FinancialInstrumentContractTypeEnum"},"linkedEntities":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentLinkedEntityData"}},"availability":{"$ref":"#/components/schemas/FinancialInstrumentAvailabilityData"},"displayData":{"$ref":"#/components/schemas/FinancialInstrumentDisplayData"},"performanceData":{"$ref":"#/components/schemas/FinancialInstrumentPerformanceData"},"debtInstrumentData":{"$ref":"#/components/schemas/FinancialInstrumentDebtInstrumentData"},"derivativeData":{"$ref":"#/components/schemas/FinancialInstrumentDerivativeData"},"commodityDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentCommodityDerivativeData"},"interestRateDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentInterestRateDerivativeData"},"foreignExchangeDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentForeignExchangeDerivativeData"},"emissionAllowanceData":{"$ref":"#/components/schemas/FinancialInstrumentEmissionAllowanceData"},"contractsForDifferenceData":{"$ref":"#/components/schemas/FinancialInstrumentContractsForDifferenceData"},"creditDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentCreditDerivativeData"},"internalId":{"type":"string","readOnly":true,"maxLength":255},"issuerData":{"$ref":"#/components/schemas/PublicIssuerData"}}},"FinancialInstrumentStatusEnum":{"type":"string","enum":["CREATED","APPROVED","ACTIVE","EXPIRED","DEACTIVATED"]},"BlockChainEnum":{"type":"string","enum":["POLYGON","STELLAR"]},"MifirIdentifierEnum":{"type":"string","enum":["SDRV","SFPS","BOND","ETCS","ETNS","EMAL","DERV","SHRS","ETFS","DPRS","CRFT","OTHR","NA"]},"AssetClassOfUnderlyingEnum":{"type":"string","enum":["INTR","EQUI","COMM","CRDT","CURR","EMAL","OCTN"]},"FinancialInstrumentContractTypeEnum":{"type":"string","enum":["OPTN","FUTR","FRAS","FORW","SWAP","PSWP","SWPT","OPTS","FONS","FWOS","SPDB","CFDS","OTHR"]},"FinancialInstrumentLinkedEntityData":{"required":["entityType"],"type":"object","properties":{"entityType":{"$ref":"#/components/schemas/FinancialInstrumentLinkedEntityTypeEnum"},"entityId":{"type":"string","maxLength":255},"entityName":{"type":"string","maxLength":255}}},"FinancialInstrumentLinkedEntityTypeEnum":{"type":"string","enum":["DISTRIBUTOR","FUND_ADMINISTRATOR","TOKENIZER","MARKET_MAKER","SUPERVISORY_AUTHORITY","PORTFOLIO_MANAGER","MANAGEMENT_COMPANY","INVESTMENT_MANAGER","EXECUTION_AGENT","BROKER","LISTING_SPONSOR","REGISTRAR","UNDERLYING_ISSUER"]},"FinancialInstrumentAvailabilityData":{"type":"object","properties":{"classification":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentClassificationEnum"}},"distribution":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentDistributionEnum"}},"jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":255}}}},"FinancialInstrumentClassificationEnum":{"type":"string","enum":["RETAIL","PROFESSIONAL"]},"FinancialInstrumentDistributionEnum":{"type":"string","enum":["NATURAL_PERSON","LEGAL_ENTITY"]},"FinancialInstrumentDisplayData":{"type":"object","properties":{"assetType":{"$ref":"#/components/schemas/FinancialInstrumentAssetTypeEnum","readOnly":true},"subAssetType":{"$ref":"#/components/schemas/FinancialInstrumentAssetSubtypeEnum","readOnly":true},"prospectusLink":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":2000},"replication":{"type":"string","maxLength":100},"investmentStyle":{"type":"string","maxLength":100},"useOfIncome":{"$ref":"#/components/schemas/FinancialInstrumentUseOfIncomeTypeEnum"},"instrumentName":{"type":"string","maxLength":255},"instrumentNickname":{"type":"string","maxLength":255},"underlyingInstrumentName":{"type":"string","maxLength":255},"underlyingInstrumentNickname":{"type":"string","maxLength":255},"linkToUnderlying":{"type":"string","maxLength":255}}},"FinancialInstrumentAssetTypeEnum":{"type":"string","enum":["C_COLLECTIVE_INVESTMENT_VEHICLES","D_DEBT_INSTRUMENTS","E_EQUITIES","F_FUTURES","H_NON_LISTED_COMPLEX_OPTIONS","J_FORWARDS","O_LISTED_OPTIONS","R_ENTITLEMENT","S_SWAPS","I_SPOT"]},"FinancialInstrumentAssetSubtypeEnum":{"type":"string","enum":["C_I","C_H","C_B","C_E","C_S","C_F","C_P","C_M","D_B","D_C","D_W","D_T","D_Y","D_S","D_E","D_G","D_A","D_N","D_D","D_M","E_S","E_P","E_C","E_F","E_L","E_D","E_Y","E_M","F_F","F_C","H_R","H_T","H_E","H_C","H_F","H_M","J_E","J_F","J_C","J_R","J_T","O_C","O_P","O_M","R_A","R_S","R_P","R_W","R_F","R_D","R_M","S_R","S_T","S_E","S_C","S_F","S_M","I_F","I_T"]},"FinancialInstrumentUseOfIncomeTypeEnum":{"type":"string","enum":["ACCUMULATING","DISTRIBUTING"]},"FinancialInstrumentPerformanceData":{"type":"object","properties":{"nav":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"navCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"navLastUpdate":{"type":"string","format":"date"},"navSource":{"type":"string","maxLength":255},"totalExpenseRatio":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"assetsUnderManagement":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"assetsUnderManagementCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"assetsUnderManagementLastUpdate":{"type":"string","format":"date"}}},"FinancialInstrumentDebtInstrumentData":{"type":"object","properties":{"totalIssuedNominalAmount":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"maturityDate":{"type":"string","format":"date"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"minimumTradedValue":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"fixedRate":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"bondSeniority":{"$ref":"#/components/schemas/FinancialInstrumentSeniorityEnum"},"bondType":{"$ref":"#/components/schemas/FinancialInstrumentBondTypeEnum"},"bondIssuanceDate":{"type":"string","format":"date"},"indexBenchmark":{"$ref":"#/components/schemas/FinancialInstrumentIndexBenchmarkData"}}},"FinancialInstrumentSeniorityEnum":{"type":"string","enum":["SNDB","MZZD","SBOD","JUND"]},"FinancialInstrumentBondTypeEnum":{"type":"string","enum":["EUSB","OEPB","CVTB","CVDB","CRPB","OTHR"]},"FinancialInstrumentIndexBenchmarkData":{"type":"object","properties":{"isin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"index":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"indexName":{"type":"string","maxLength":25},"indexTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"indexTermValue":{"type":"integer","format":"int32","minimum":0},"basePointSpread":{"type":"integer","format":"int32","minimum":0}}},"IndexDefinitionEnum":{"type":"string","enum":["OTHR","EONA","EONS","EURI","EUUS","EUCH","GCFR","ISDA","LIBI","LIBO","MAAA","PFAN","TIBO","STBO","BBSW","JIBA","BUBO","CDOR","CIBO","MOSP","NIBO","PRBO","TLBO","WIBO","TREA","SWAP","FUSW"]},"FinancialInstrumentIndexTermUnitEnum":{"type":"string","enum":["DAYS","WEEK","MNTH","YEAR"]},"FinancialInstrumentDerivativeData":{"type":"object","properties":{"expiryDate":{"type":"string","format":"date"},"priceMultiplier":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"optionType":{"$ref":"#/components/schemas/FinancialInstrumentOptionTypeEnum"},"strikePriceType":{"$ref":"#/components/schemas/FinancialInstrumentStrikePriceTypeEnum"},"strikePriceValue":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"strikePriceCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"optionExerciseStyle":{"$ref":"#/components/schemas/FinancialInstrumentOptionExcerciseStyleEnum"},"deliveryType":{"$ref":"#/components/schemas/FinancialInstrumentDeliveryTypeEnum"},"equityDerivativeUnderlyingType":{"$ref":"#/components/schemas/EquityDerivativeUnderlyingTypeEnum"},"equityDerivativeParameter":{"$ref":"#/components/schemas/EquityDerivativeParameterTypeEnum"},"underlyingInstruments":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentUnderlyingInstrumentData"}}}},"FinancialInstrumentOptionTypeEnum":{"type":"string","enum":["PUTO","CALL","OTHR"]},"FinancialInstrumentStrikePriceTypeEnum":{"type":"string","enum":["MONE","PERC","YIEL","BIPS","PNDG"]},"FinancialInstrumentOptionExcerciseStyleEnum":{"type":"string","enum":["EURO","AMER","ASIA","BERM","OTHR"]},"FinancialInstrumentDeliveryTypeEnum":{"type":"string","enum":["PHYS","CASH","OPTL"]},"EquityDerivativeUnderlyingTypeEnum":{"type":"string","enum":["STIX","SHRS","DIVI","DVSE","BSKT","ETFS","VOLI","OTHR"]},"EquityDerivativeParameterTypeEnum":{"type":"string","enum":["PRBP","PRDV","PRVA","PRVO"]},"FinancialInstrumentUnderlyingInstrumentData":{"type":"object","properties":{"isin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"issuerLei":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255},"index":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"indexName":{"type":"string","maxLength":25},"indexTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"indexTermValue":{"type":"integer","format":"int32","minimum":0}}},"FinancialInstrumentCommodityDerivativeData":{"type":"object","properties":{"baseProduct":{"$ref":"#/components/schemas/CommodityDerivativesProductEnum"},"subProduct":{"$ref":"#/components/schemas/CommodityDerivativesSubProductEnum"},"furtherSubProduct":{"$ref":"#/components/schemas/CommodityDerivativesFurtherSubProductEnum"},"transactionType":{"$ref":"#/components/schemas/CommodityDerivativeTransactionTypeEnum"},"finalPriceType":{"$ref":"#/components/schemas/CommodityDerivativeFinalPriceTypeEnum"},"sizeSpecification":{"$ref":"#/components/schemas/CommodityDerivativeSizeSpecificationEnum"},"freightRoute":{"type":"string","maxLength":6},"settlementLocation":{"type":"string","maxLength":16},"commodityNotionalCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"emissionAllowanceSubType":{"$ref":"#/components/schemas/EmissionAllowanceSubTypeEnum"}}},"CommodityDerivativesProductEnum":{"type":"string","enum":["AGRI","NRGY","ENVR","FRGT","FRTL","INDP","METL","MCEX","PAPR","POLY","INFL","OEST","OTHC","OTHR"]},"CommodityDerivativesSubProductEnum":{"type":"string","enum":["GROS","SOFT","POTA","OOLI","DIRY","FRST","SEAF","LSTK","GRIN","ELEC","NGAS","OILP","COAL","INRG","RNNG","LGHT","DIST","EMIS","WTHR","CRBR","WETF","DRYF","CSHP","AMMO","DAPH","PTSH","SLPH","UREA","UAAN","CSTR","MFTG","NPRM","PRME","CBRD","NSPT","PULP","RCVP","PLST","DLVR","NDLV"]},"CommodityDerivativesFurtherSubProductEnum":{"type":"string","enum":["FWHT","SOYB","CORN","RPSD","RICE","OTHR","CCOA","ROBU","WHSG","BRWN","LAMP","MWHT","BSLD","FITR","PKLD","OFFP","GASP","LNGG","NBPG","NCGG","TTFG","BAKK","BDSL","BRNT","BRNX","CNDA","COND","DSEL","DUBA","ESPO","ETHA","FUEL","FOIL","GOIL","GSLN","HEAT","JTFL","KERO","LLSO","MARS","NAPH","NGLO","TAPI","URAL","WTIO","CERE","ERUE","EUAE","EUAA","TNKR","DBCR","ALUM","ALUA","CBLT","COPR","IRON","LEAD","MOLY","NASC","NICK","STEL","TINN","ZINC","GOLD","SLVR","PTNM","PLDM"]},"CommodityDerivativeTransactionTypeEnum":{"type":"string","enum":["FUTR","OPTN","TAPO","SWAP","MINI","OTCT","ORIT","CRCK","DIFF","OTHR"]},"CommodityDerivativeFinalPriceTypeEnum":{"type":"string","enum":["ARGM","BLTC","EXOF","GBCL","IHSM","PLAT","OTHR"]},"CommodityDerivativeSizeSpecificationEnum":{"type":"string","enum":["CAPE","PNMX","SPMX","HAND","CLAN","DRTY"]},"EmissionAllowanceSubTypeEnum":{"type":"string","enum":["CERE","ERUE","EUAE","EUAA","OTHR"]},"FinancialInstrumentInterestRateDerivativeData":{"type":"object","properties":{"referenceRateIndex":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"referenceRateName":{"type":"string","maxLength":25},"interestRateTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"interestRateTermValue":{"type":"integer","format":"int32","minimum":0},"notionalCurrency2":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"fixedRateLeg1":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"fixedRateLeg2":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"floatingRateLeg2Index":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"floatingRateLeg2Name":{"type":"string","maxLength":25},"interestRateLeg2TermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"interestRateLeg2TermValue":{"type":"integer","format":"int32","minimum":0},"underlyingInterestRateDerivativeType":{"$ref":"#/components/schemas/InterestRateDerivativeUnderlyingTypeEnum"},"underlyingInterestRateDerivativeIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"underlyingInterestRateDerivativeIndexName":{"type":"string","maxLength":25},"underlyingInterestRateDerivativeReferenceRateIndex":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"underlyingInterestRateDerivativeReferenceRateName":{"type":"string","maxLength":25},"underlyingInterestRateDerivativeTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"underlyingInterestRateDerivativeTermValue":{"type":"integer","format":"int32","minimum":0},"underlyingInterestRateDerivativeBond":{"$ref":"#/components/schemas/UnderlyingInterestRateDerivativeBondData"},"underlyingInterestRateDerivativeSwap":{"$ref":"#/components/schemas/UnderlyingInterestRateDerivativeSwapData"}}},"InterestRateDerivativeUnderlyingTypeEnum":{"type":"string","enum":["BOND","BNDF","INTR","IFUT","FFMC","XFMC","XXMC","OSMC","IFMC","FFSC","XFSC","XXSC","OSSC","IFSC"]},"UnderlyingInterestRateDerivativeBondData":{"type":"object","properties":{"issuerLei":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255},"maturityDate":{"type":"string","format":"date"},"issuanceDate":{"type":"string","format":"date"}}},"UnderlyingInterestRateDerivativeSwapData":{"type":"object","properties":{"notionalCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"maturityDate":{"type":"string","format":"date"}}},"FinancialInstrumentForeignExchangeDerivativeData":{"type":"object","properties":{"notionalCurrency2":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"foreignExchangeType":{"$ref":"#/components/schemas/ForeignExchangeDerivativeTypeEnum"},"foreignExchangeContractSubType":{"$ref":"#/components/schemas/ForeignExchangeDerivativeContractSubTypeEnum"}}},"ForeignExchangeDerivativeTypeEnum":{"type":"string","enum":["FXCR","FXEM","FXMJ"]},"ForeignExchangeDerivativeContractSubTypeEnum":{"type":"string","enum":["DLVB","NDLV"]},"FinancialInstrumentEmissionAllowanceData":{"type":"object","properties":{"subType":{"$ref":"#/components/schemas/EmissionAllowanceSubTypeEnum"}}},"FinancialInstrumentContractsForDifferenceData":{"type":"object","properties":{"underlyingType":{"$ref":"#/components/schemas/ContractsForDifferenceUnderlyingTypeEnum"},"notionalCurrency1":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"notionalCurrency2":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255}}},"ContractsForDifferenceUnderlyingTypeEnum":{"type":"string","enum":["CURR","EQUI","BOND","FTEQ","OPEQ","COMM","EMAL","OTHR"]},"FinancialInstrumentCreditDerivativeData":{"type":"object","properties":{"underlyingSwapIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"underlyingIndexIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"underlyingIndexName":{"type":"string","maxLength":25},"series":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"version":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"rollMonths":{"type":"array","items":{"type":"string","pattern":"^((0[1-9])|(1[012]))$","maxLength":255}},"nextRollDate":{"type":"string","format":"date"},"issuerSovereignPublic":{"type":"boolean","default":false},"referenceObligationIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"referenceEntityCountry":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":255},"referenceEntitySubDivision":{"type":"string","maxLength":6},"referenceEntityLei":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255},"referenceEntityNotionalCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255}}},"PublicIssuerData":{"type":"object","properties":{"companyName":{"type":"string","maxLength":255},"website":{"type":"string","maxLength":255},"legalAddress":{"$ref":"#/components/schemas/AddressData"},"legalEntityIdentifier":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255}}},"AddressData":{"required":["countryCode","areaCode","city","street"],"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2},"areaCode":{"type":"string","maxLength":50},"city":{"type":"string","maxLength":50},"street":{"type":"string","maxLength":50},"postOfficeBox":{"type":"string","maxLength":50},"addressSupplement":{"type":"string","maxLength":255}}},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/financialinstruments/{id}":{"get":{"tags":["PublicMarketData"],"summary":"getFinancialInstrument","description":"Anonymous endpoint that returns extended information on a financial instrument\n","operationId":"getFinancialInstrument","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancialInstrumentPublic"}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getTradingPairs
> Anonymous endpoint that lists all available trading pairs
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"cursor":{"name":"cursor","description":"Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous response.\n","in":"query","required":false,"schema":{"type":"string"}},"limit":{"name":"limit","description":"The maximum number of items to return.\n","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},"count":{"name":"count","description":"Returns the total number of items in the collection.\n","in":"query","required":false,"schema":{"type":"boolean"}}},"schemas":{"TradingPairList":{"required":["items"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TradingPair"}},"next_cursor":{"type":"string","maxLength":255},"total_count":{"type":"integer","format":"int64","minimum":0}}},"TradingPair":{"required":["id","quoteTokenSymbol","smartContractOrderBook","smartContractBase","smartContractQuote","baseTokenNativeScale","quoteTokenNativeScale","baseTokenInternalScale","quoteTokenInternalScale","quoteTokenEquivalentCurrency"],"type":"object","properties":{"id":{"type":"string","readOnly":true,"maxLength":255},"creationDate":{"type":"string","format":"date-time","readOnly":true},"modificationDate":{"type":"string","format":"date-time","readOnly":true},"quoteTokenSymbol":{"description":"The symbol of the e-money token that the financial instrument is traded in\n","type":"string","maxLength":255},"minimumSizeIncrement":{"description":"Smallest valid order size increment. All order sizes must be minimumTradeVolume + x*minimumSizeIncrement\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"priceCollarFactor":{"description":"The price collar factor is used for pre-trade controls to determine the minimum and maximum limit price allowed.\n","type":"integer","format":"int64","minimum":0},"maximumMatches":{"description":"The maximum number of standing orders in the order book that an incoming order can be matched with.\n","type":"integer","format":"int32","minimum":0},"staticThreshold":{"description":"The percentage range around the static reference price that the execution price must have (in base points)\n","type":"integer","format":"int32","minimum":0},"dynamicThreshold":{"description":"The percentage range around the dynamic reference price that the execution price must have (in base points)\n","type":"integer","format":"int32","minimum":0},"liquidityBand":{"description":"The liquidity band used for tick size checks\n","type":"integer","format":"int32","minimum":0},"blockChain":{"description":"The blockchain that the associated smart contracts run on.\n","$ref":"#/components/schemas/BlockChainEnum"},"smartContractOrderBook":{"description":"The blockchain address of the order book smart contract. Orders need to be sent to this address.\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"smartContractBase":{"description":"The blockchain address of the financial instrument token smart contract.\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"smartContractQuote":{"description":"The blockchain address of the e-money token smart contract.\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"makerCommission":{"description":"Maker commission in base points (10^-4)\n","type":"integer","format":"int32","minimum":0},"takerCommission":{"description":"Taker commission in base points (10^-4)\n","type":"integer","format":"int32","minimum":0},"marketMakerCommission":{"description":"Market maker commission in base points (10^-4)\n","type":"integer","format":"int32","minimum":0},"baseTokenNativeScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"quoteTokenNativeScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"tradingStatus":{"description":"Status indicating if/how the trading pair can be used for trading\n","$ref":"#/components/schemas/TradingStatusEnum","readOnly":true,"default":"OUT_OF_TRADING"},"orderBookVersion":{"type":"string","maxLength":255},"statusChangeReason":{"description":"Reason why the last status change was made\n","$ref":"#/components/schemas/TradingStatusChangeReasonEnum"},"statusChangeReasonText":{"description":"Reason why the last status change was made (free text)\n","type":"string","maxLength":255},"baseTokenInternalScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"quoteTokenInternalScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"quoteTokenEquivalentCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"staticReferencePrice":{"description":"The static reference price. Updated automatically after each trading day.\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"minimumOrderValue":{"description":"The minimum value (in quote tokens) that a valid order must have.\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"maximumOrderValue":{"description":"The maximum value (in quote tokens) that a valid order can have.\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"baseTokenData":{"$ref":"#/components/schemas/FinancialInstrumentTableBase"}}},"BlockChainEnum":{"type":"string","enum":["POLYGON","STELLAR"]},"TradingStatusEnum":{"type":"string","enum":["CREATED","CONTINUOUS_TRADING","OUT_OF_TRADING","AUTOMATIC_TRADING_HALT","MANUAL_TRADING_HALT","DISABLED","PERMANENTLY_DELETED"]},"TradingStatusChangeReasonEnum":{"type":"string","enum":["START_OF_TRADING_DAY","MANUAL_MARKET_OPEN","END_OF_TRADING_DAY","MANUAL_MARKET_CLOSE","REGULATOR_INITIATED_HALT","PARTICIPANT_INITIATED_HALT","VENUE_INITIATED_HALT","CAPACITY_LIMIT_HALT","VOLATILITY_HALT","TECHNICAL_HALT","TRADING_PAIR_ACTIVATION","TRADING_PAIR_DEACTIVATION","TRADING_PAIR_OFFBOARDING","TRADING_PAIR_CREATION","AUTOMATIC_RESUME"]},"FinancialInstrumentTableBase":{"type":"object","properties":{"symbol":{"description":"The financial instrument's symbol\n","type":"string","maxLength":255},"fullName":{"description":"The financial instrument's name\n","type":"string","maxLength":255},"status":{"description":"Trading status of the financial instrument\n","$ref":"#/components/schemas/FinancialInstrumentStatusEnum","readOnly":true},"isin":{"description":"International Securities Identification Number (ISIN) of the financial instrument\n","type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"dti":{"description":"Digital Token Identifier (DTI) of the financial instrument\n","type":"string","maxLength":255},"issuerName":{"description":"Name of the issuer of the financial instrument\n","type":"string","maxLength":255},"prospectusLink":{"description":"Link to further information about the financial instrument\n","type":"string","readOnly":true,"maxLength":255},"effectiveDate":{"description":"First day of active trading on 21X\n","type":"string","format":"date-time"},"terminationDate":{"description":"Last day of trading on 21X\n","type":"string","format":"date-time"},"smartContractAddress":{"description":"The blockchain address of the financial instrument's smart contract\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255}}},"FinancialInstrumentStatusEnum":{"type":"string","enum":["CREATED","APPROVED","ACTIVE","EXPIRED","DEACTIVATED"]},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/tradingpairs":{"get":{"tags":["PublicMarketData"],"summary":"getTradingPairs","description":"Anonymous endpoint that lists all available trading pairs\n","operationId":"getTradingPairs","parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/count"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradingPairList"}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getTradingPair
> Anonymous endpoint that returns extended information on a trading pair
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"TradingPairPublicExtended":{"required":["quoteTokenSymbol","smartContractOrderBook","smartContractBase","smartContractQuote","baseTokenNativeScale","quoteTokenNativeScale","baseTokenInternalScale","quoteTokenInternalScale","quoteTokenEquivalentCurrency"],"type":"object","properties":{"creationDate":{"type":"string","format":"date-time","readOnly":true},"modificationDate":{"type":"string","format":"date-time","readOnly":true},"quoteTokenSymbol":{"description":"The symbol of the e-money token that the financial instrument is traded in\n","type":"string","maxLength":255},"minimumSizeIncrement":{"description":"Smallest valid order size increment. All order sizes must be minimumTradeVolume + x*minimumSizeIncrement\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"priceCollarFactor":{"description":"The price collar factor is used for pre-trade controls to determine the minimum and maximum limit price allowed.\n","type":"integer","format":"int64","minimum":0},"maximumMatches":{"description":"The maximum number of standing orders in the order book that an incoming order can be matched with.\n","type":"integer","format":"int32","minimum":0},"staticThreshold":{"description":"The percentage range around the static reference price that the execution price must have (in base points)\n","type":"integer","format":"int32","minimum":0},"dynamicThreshold":{"description":"The percentage range around the dynamic reference price that the execution price must have (in base points)\n","type":"integer","format":"int32","minimum":0},"liquidityBand":{"description":"The liquidity band used for tick size checks\n","type":"integer","format":"int32","minimum":0},"blockChain":{"description":"The blockchain that the associated smart contracts run on.\n","$ref":"#/components/schemas/BlockChainEnum"},"smartContractOrderBook":{"description":"The blockchain address of the order book smart contract. Orders need to be sent to this address.\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"smartContractBase":{"description":"The blockchain address of the financial instrument token smart contract.\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"smartContractQuote":{"description":"The blockchain address of the e-money token smart contract.\n","type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"makerCommission":{"description":"Maker commission in base points (10^-4)\n","type":"integer","format":"int32","minimum":0},"takerCommission":{"description":"Taker commission in base points (10^-4)\n","type":"integer","format":"int32","minimum":0},"marketMakerCommission":{"description":"Market maker commission in base points (10^-4)\n","type":"integer","format":"int32","minimum":0},"baseTokenNativeScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"quoteTokenNativeScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"tradingStatus":{"description":"Status indicating if/how the trading pair can be used for trading\n","$ref":"#/components/schemas/TradingStatusEnum","readOnly":true,"default":"OUT_OF_TRADING"},"orderBookVersion":{"type":"string","maxLength":255},"statusChangeReason":{"description":"Reason why the last status change was made\n","$ref":"#/components/schemas/TradingStatusChangeReasonEnum"},"statusChangeReasonText":{"description":"Reason why the last status change was made (free text)\n","type":"string","maxLength":255},"baseTokenInternalScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"quoteTokenInternalScale":{"type":"string","pattern":"^-?[0-9]{1,38}$","maxLength":255},"quoteTokenEquivalentCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"staticReferencePrice":{"description":"The static reference price. Updated automatically after each trading day.\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"minimumOrderValue":{"description":"The minimum value (in quote tokens) that a valid order must have.\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"maximumOrderValue":{"description":"The maximum value (in quote tokens) that a valid order can have.\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"baseTokenData":{"$ref":"#/components/schemas/FinancialInstrumentPublic"}}},"BlockChainEnum":{"type":"string","enum":["POLYGON","STELLAR"]},"TradingStatusEnum":{"type":"string","enum":["CREATED","CONTINUOUS_TRADING","OUT_OF_TRADING","AUTOMATIC_TRADING_HALT","MANUAL_TRADING_HALT","DISABLED","PERMANENTLY_DELETED"]},"TradingStatusChangeReasonEnum":{"type":"string","enum":["START_OF_TRADING_DAY","MANUAL_MARKET_OPEN","END_OF_TRADING_DAY","MANUAL_MARKET_CLOSE","REGULATOR_INITIATED_HALT","PARTICIPANT_INITIATED_HALT","VENUE_INITIATED_HALT","CAPACITY_LIMIT_HALT","VOLATILITY_HALT","TECHNICAL_HALT","TRADING_PAIR_ACTIVATION","TRADING_PAIR_DEACTIVATION","TRADING_PAIR_OFFBOARDING","TRADING_PAIR_CREATION","AUTOMATIC_RESUME"]},"FinancialInstrumentPublic":{"required":["fullName"],"type":"object","properties":{"status":{"$ref":"#/components/schemas/FinancialInstrumentStatusEnum","readOnly":true,"default":"CREATED"},"domicile":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":255},"wkn":{"type":"string","maxLength":6},"sedol":{"type":"string","maxLength":7},"cusip":{"type":"string","maxLength":9},"valor":{"type":"string","maxLength":50},"dti":{"type":"string","maxLength":9},"symbol":{"type":"string","maxLength":10},"protocol":{"$ref":"#/components/schemas/BlockChainEnum"},"smartContractAddress":{"type":"string","pattern":"^(0x)?[0-9a-fA-F]+$","maxLength":255},"isin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"fullName":{"type":"string","maxLength":255},"cfi":{"type":"string","pattern":"^[A-Z]{6}$","maxLength":255},"commoditiesDerivativeIndicator":{"type":"boolean","default":false},"issuerId":{"type":"string","maxLength":255},"issuerName":{"type":"string","maxLength":255},"tradingVenue":{"type":"string","maxLength":4,"default":"21XX"},"fisn":{"type":"string","maxLength":35},"issuerRequestForAdmissionToTrade":{"type":"boolean","default":false},"listingDate":{"type":"string","format":"date"},"issuerApprovalDate":{"type":"string","format":"date-time"},"admissionToTradeRequestDate":{"type":"string","format":"date-time"},"effectiveDate":{"type":"string","format":"date-time"},"terminationDate":{"type":"string","format":"date-time"},"notionalCurrency1":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255,"default":"EUR"},"mifirIdentifier":{"$ref":"#/components/schemas/MifirIdentifierEnum"},"numberOfOutstandingInstruments":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"holdingsExceedingTotalVotingRightThreshold":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"issuanceSize":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"assetClassOfUnderlying":{"$ref":"#/components/schemas/AssetClassOfUnderlyingEnum"},"maturityDate":{"type":"string","format":"date"},"contractType":{"$ref":"#/components/schemas/FinancialInstrumentContractTypeEnum"},"linkedEntities":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentLinkedEntityData"}},"availability":{"$ref":"#/components/schemas/FinancialInstrumentAvailabilityData"},"displayData":{"$ref":"#/components/schemas/FinancialInstrumentDisplayData"},"performanceData":{"$ref":"#/components/schemas/FinancialInstrumentPerformanceData"},"debtInstrumentData":{"$ref":"#/components/schemas/FinancialInstrumentDebtInstrumentData"},"derivativeData":{"$ref":"#/components/schemas/FinancialInstrumentDerivativeData"},"commodityDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentCommodityDerivativeData"},"interestRateDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentInterestRateDerivativeData"},"foreignExchangeDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentForeignExchangeDerivativeData"},"emissionAllowanceData":{"$ref":"#/components/schemas/FinancialInstrumentEmissionAllowanceData"},"contractsForDifferenceData":{"$ref":"#/components/schemas/FinancialInstrumentContractsForDifferenceData"},"creditDerivativeData":{"$ref":"#/components/schemas/FinancialInstrumentCreditDerivativeData"},"internalId":{"type":"string","readOnly":true,"maxLength":255},"issuerData":{"$ref":"#/components/schemas/PublicIssuerData"}}},"FinancialInstrumentStatusEnum":{"type":"string","enum":["CREATED","APPROVED","ACTIVE","EXPIRED","DEACTIVATED"]},"MifirIdentifierEnum":{"type":"string","enum":["SDRV","SFPS","BOND","ETCS","ETNS","EMAL","DERV","SHRS","ETFS","DPRS","CRFT","OTHR","NA"]},"AssetClassOfUnderlyingEnum":{"type":"string","enum":["INTR","EQUI","COMM","CRDT","CURR","EMAL","OCTN"]},"FinancialInstrumentContractTypeEnum":{"type":"string","enum":["OPTN","FUTR","FRAS","FORW","SWAP","PSWP","SWPT","OPTS","FONS","FWOS","SPDB","CFDS","OTHR"]},"FinancialInstrumentLinkedEntityData":{"required":["entityType"],"type":"object","properties":{"entityType":{"$ref":"#/components/schemas/FinancialInstrumentLinkedEntityTypeEnum"},"entityId":{"type":"string","maxLength":255},"entityName":{"type":"string","maxLength":255}}},"FinancialInstrumentLinkedEntityTypeEnum":{"type":"string","enum":["DISTRIBUTOR","FUND_ADMINISTRATOR","TOKENIZER","MARKET_MAKER","SUPERVISORY_AUTHORITY","PORTFOLIO_MANAGER","MANAGEMENT_COMPANY","INVESTMENT_MANAGER","EXECUTION_AGENT","BROKER","LISTING_SPONSOR","REGISTRAR","UNDERLYING_ISSUER"]},"FinancialInstrumentAvailabilityData":{"type":"object","properties":{"classification":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentClassificationEnum"}},"distribution":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentDistributionEnum"}},"jurisdictions":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":255}}}},"FinancialInstrumentClassificationEnum":{"type":"string","enum":["RETAIL","PROFESSIONAL"]},"FinancialInstrumentDistributionEnum":{"type":"string","enum":["NATURAL_PERSON","LEGAL_ENTITY"]},"FinancialInstrumentDisplayData":{"type":"object","properties":{"assetType":{"$ref":"#/components/schemas/FinancialInstrumentAssetTypeEnum","readOnly":true},"subAssetType":{"$ref":"#/components/schemas/FinancialInstrumentAssetSubtypeEnum","readOnly":true},"prospectusLink":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":2000},"replication":{"type":"string","maxLength":100},"investmentStyle":{"type":"string","maxLength":100},"useOfIncome":{"$ref":"#/components/schemas/FinancialInstrumentUseOfIncomeTypeEnum"},"instrumentName":{"type":"string","maxLength":255},"instrumentNickname":{"type":"string","maxLength":255},"underlyingInstrumentName":{"type":"string","maxLength":255},"underlyingInstrumentNickname":{"type":"string","maxLength":255},"linkToUnderlying":{"type":"string","maxLength":255}}},"FinancialInstrumentAssetTypeEnum":{"type":"string","enum":["C_COLLECTIVE_INVESTMENT_VEHICLES","D_DEBT_INSTRUMENTS","E_EQUITIES","F_FUTURES","H_NON_LISTED_COMPLEX_OPTIONS","J_FORWARDS","O_LISTED_OPTIONS","R_ENTITLEMENT","S_SWAPS","I_SPOT"]},"FinancialInstrumentAssetSubtypeEnum":{"type":"string","enum":["C_I","C_H","C_B","C_E","C_S","C_F","C_P","C_M","D_B","D_C","D_W","D_T","D_Y","D_S","D_E","D_G","D_A","D_N","D_D","D_M","E_S","E_P","E_C","E_F","E_L","E_D","E_Y","E_M","F_F","F_C","H_R","H_T","H_E","H_C","H_F","H_M","J_E","J_F","J_C","J_R","J_T","O_C","O_P","O_M","R_A","R_S","R_P","R_W","R_F","R_D","R_M","S_R","S_T","S_E","S_C","S_F","S_M","I_F","I_T"]},"FinancialInstrumentUseOfIncomeTypeEnum":{"type":"string","enum":["ACCUMULATING","DISTRIBUTING"]},"FinancialInstrumentPerformanceData":{"type":"object","properties":{"nav":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"navCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"navLastUpdate":{"type":"string","format":"date"},"navSource":{"type":"string","maxLength":255},"totalExpenseRatio":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"assetsUnderManagement":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"assetsUnderManagementCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"assetsUnderManagementLastUpdate":{"type":"string","format":"date"}}},"FinancialInstrumentDebtInstrumentData":{"type":"object","properties":{"totalIssuedNominalAmount":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"maturityDate":{"type":"string","format":"date"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"minimumTradedValue":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"fixedRate":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"bondSeniority":{"$ref":"#/components/schemas/FinancialInstrumentSeniorityEnum"},"bondType":{"$ref":"#/components/schemas/FinancialInstrumentBondTypeEnum"},"bondIssuanceDate":{"type":"string","format":"date"},"indexBenchmark":{"$ref":"#/components/schemas/FinancialInstrumentIndexBenchmarkData"}}},"FinancialInstrumentSeniorityEnum":{"type":"string","enum":["SNDB","MZZD","SBOD","JUND"]},"FinancialInstrumentBondTypeEnum":{"type":"string","enum":["EUSB","OEPB","CVTB","CVDB","CRPB","OTHR"]},"FinancialInstrumentIndexBenchmarkData":{"type":"object","properties":{"isin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"index":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"indexName":{"type":"string","maxLength":25},"indexTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"indexTermValue":{"type":"integer","format":"int32","minimum":0},"basePointSpread":{"type":"integer","format":"int32","minimum":0}}},"IndexDefinitionEnum":{"type":"string","enum":["OTHR","EONA","EONS","EURI","EUUS","EUCH","GCFR","ISDA","LIBI","LIBO","MAAA","PFAN","TIBO","STBO","BBSW","JIBA","BUBO","CDOR","CIBO","MOSP","NIBO","PRBO","TLBO","WIBO","TREA","SWAP","FUSW"]},"FinancialInstrumentIndexTermUnitEnum":{"type":"string","enum":["DAYS","WEEK","MNTH","YEAR"]},"FinancialInstrumentDerivativeData":{"type":"object","properties":{"expiryDate":{"type":"string","format":"date"},"priceMultiplier":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"optionType":{"$ref":"#/components/schemas/FinancialInstrumentOptionTypeEnum"},"strikePriceType":{"$ref":"#/components/schemas/FinancialInstrumentStrikePriceTypeEnum"},"strikePriceValue":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"strikePriceCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"optionExerciseStyle":{"$ref":"#/components/schemas/FinancialInstrumentOptionExcerciseStyleEnum"},"deliveryType":{"$ref":"#/components/schemas/FinancialInstrumentDeliveryTypeEnum"},"equityDerivativeUnderlyingType":{"$ref":"#/components/schemas/EquityDerivativeUnderlyingTypeEnum"},"equityDerivativeParameter":{"$ref":"#/components/schemas/EquityDerivativeParameterTypeEnum"},"underlyingInstruments":{"type":"array","items":{"$ref":"#/components/schemas/FinancialInstrumentUnderlyingInstrumentData"}}}},"FinancialInstrumentOptionTypeEnum":{"type":"string","enum":["PUTO","CALL","OTHR"]},"FinancialInstrumentStrikePriceTypeEnum":{"type":"string","enum":["MONE","PERC","YIEL","BIPS","PNDG"]},"FinancialInstrumentOptionExcerciseStyleEnum":{"type":"string","enum":["EURO","AMER","ASIA","BERM","OTHR"]},"FinancialInstrumentDeliveryTypeEnum":{"type":"string","enum":["PHYS","CASH","OPTL"]},"EquityDerivativeUnderlyingTypeEnum":{"type":"string","enum":["STIX","SHRS","DIVI","DVSE","BSKT","ETFS","VOLI","OTHR"]},"EquityDerivativeParameterTypeEnum":{"type":"string","enum":["PRBP","PRDV","PRVA","PRVO"]},"FinancialInstrumentUnderlyingInstrumentData":{"type":"object","properties":{"isin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"issuerLei":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255},"index":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"indexName":{"type":"string","maxLength":25},"indexTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"indexTermValue":{"type":"integer","format":"int32","minimum":0}}},"FinancialInstrumentCommodityDerivativeData":{"type":"object","properties":{"baseProduct":{"$ref":"#/components/schemas/CommodityDerivativesProductEnum"},"subProduct":{"$ref":"#/components/schemas/CommodityDerivativesSubProductEnum"},"furtherSubProduct":{"$ref":"#/components/schemas/CommodityDerivativesFurtherSubProductEnum"},"transactionType":{"$ref":"#/components/schemas/CommodityDerivativeTransactionTypeEnum"},"finalPriceType":{"$ref":"#/components/schemas/CommodityDerivativeFinalPriceTypeEnum"},"sizeSpecification":{"$ref":"#/components/schemas/CommodityDerivativeSizeSpecificationEnum"},"freightRoute":{"type":"string","maxLength":6},"settlementLocation":{"type":"string","maxLength":16},"commodityNotionalCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"emissionAllowanceSubType":{"$ref":"#/components/schemas/EmissionAllowanceSubTypeEnum"}}},"CommodityDerivativesProductEnum":{"type":"string","enum":["AGRI","NRGY","ENVR","FRGT","FRTL","INDP","METL","MCEX","PAPR","POLY","INFL","OEST","OTHC","OTHR"]},"CommodityDerivativesSubProductEnum":{"type":"string","enum":["GROS","SOFT","POTA","OOLI","DIRY","FRST","SEAF","LSTK","GRIN","ELEC","NGAS","OILP","COAL","INRG","RNNG","LGHT","DIST","EMIS","WTHR","CRBR","WETF","DRYF","CSHP","AMMO","DAPH","PTSH","SLPH","UREA","UAAN","CSTR","MFTG","NPRM","PRME","CBRD","NSPT","PULP","RCVP","PLST","DLVR","NDLV"]},"CommodityDerivativesFurtherSubProductEnum":{"type":"string","enum":["FWHT","SOYB","CORN","RPSD","RICE","OTHR","CCOA","ROBU","WHSG","BRWN","LAMP","MWHT","BSLD","FITR","PKLD","OFFP","GASP","LNGG","NBPG","NCGG","TTFG","BAKK","BDSL","BRNT","BRNX","CNDA","COND","DSEL","DUBA","ESPO","ETHA","FUEL","FOIL","GOIL","GSLN","HEAT","JTFL","KERO","LLSO","MARS","NAPH","NGLO","TAPI","URAL","WTIO","CERE","ERUE","EUAE","EUAA","TNKR","DBCR","ALUM","ALUA","CBLT","COPR","IRON","LEAD","MOLY","NASC","NICK","STEL","TINN","ZINC","GOLD","SLVR","PTNM","PLDM"]},"CommodityDerivativeTransactionTypeEnum":{"type":"string","enum":["FUTR","OPTN","TAPO","SWAP","MINI","OTCT","ORIT","CRCK","DIFF","OTHR"]},"CommodityDerivativeFinalPriceTypeEnum":{"type":"string","enum":["ARGM","BLTC","EXOF","GBCL","IHSM","PLAT","OTHR"]},"CommodityDerivativeSizeSpecificationEnum":{"type":"string","enum":["CAPE","PNMX","SPMX","HAND","CLAN","DRTY"]},"EmissionAllowanceSubTypeEnum":{"type":"string","enum":["CERE","ERUE","EUAE","EUAA","OTHR"]},"FinancialInstrumentInterestRateDerivativeData":{"type":"object","properties":{"referenceRateIndex":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"referenceRateName":{"type":"string","maxLength":25},"interestRateTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"interestRateTermValue":{"type":"integer","format":"int32","minimum":0},"notionalCurrency2":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"fixedRateLeg1":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"fixedRateLeg2":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"floatingRateLeg2Index":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"floatingRateLeg2Name":{"type":"string","maxLength":25},"interestRateLeg2TermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"interestRateLeg2TermValue":{"type":"integer","format":"int32","minimum":0},"underlyingInterestRateDerivativeType":{"$ref":"#/components/schemas/InterestRateDerivativeUnderlyingTypeEnum"},"underlyingInterestRateDerivativeIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"underlyingInterestRateDerivativeIndexName":{"type":"string","maxLength":25},"underlyingInterestRateDerivativeReferenceRateIndex":{"$ref":"#/components/schemas/IndexDefinitionEnum"},"underlyingInterestRateDerivativeReferenceRateName":{"type":"string","maxLength":25},"underlyingInterestRateDerivativeTermUnit":{"$ref":"#/components/schemas/FinancialInstrumentIndexTermUnitEnum"},"underlyingInterestRateDerivativeTermValue":{"type":"integer","format":"int32","minimum":0},"underlyingInterestRateDerivativeBond":{"$ref":"#/components/schemas/UnderlyingInterestRateDerivativeBondData"},"underlyingInterestRateDerivativeSwap":{"$ref":"#/components/schemas/UnderlyingInterestRateDerivativeSwapData"}}},"InterestRateDerivativeUnderlyingTypeEnum":{"type":"string","enum":["BOND","BNDF","INTR","IFUT","FFMC","XFMC","XXMC","OSMC","IFMC","FFSC","XFSC","XXSC","OSSC","IFSC"]},"UnderlyingInterestRateDerivativeBondData":{"type":"object","properties":{"issuerLei":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255},"maturityDate":{"type":"string","format":"date"},"issuanceDate":{"type":"string","format":"date"}}},"UnderlyingInterestRateDerivativeSwapData":{"type":"object","properties":{"notionalCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"maturityDate":{"type":"string","format":"date"}}},"FinancialInstrumentForeignExchangeDerivativeData":{"type":"object","properties":{"notionalCurrency2":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"foreignExchangeType":{"$ref":"#/components/schemas/ForeignExchangeDerivativeTypeEnum"},"foreignExchangeContractSubType":{"$ref":"#/components/schemas/ForeignExchangeDerivativeContractSubTypeEnum"}}},"ForeignExchangeDerivativeTypeEnum":{"type":"string","enum":["FXCR","FXEM","FXMJ"]},"ForeignExchangeDerivativeContractSubTypeEnum":{"type":"string","enum":["DLVB","NDLV"]},"FinancialInstrumentEmissionAllowanceData":{"type":"object","properties":{"subType":{"$ref":"#/components/schemas/EmissionAllowanceSubTypeEnum"}}},"FinancialInstrumentContractsForDifferenceData":{"type":"object","properties":{"underlyingType":{"$ref":"#/components/schemas/ContractsForDifferenceUnderlyingTypeEnum"},"notionalCurrency1":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255},"notionalCurrency2":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255}}},"ContractsForDifferenceUnderlyingTypeEnum":{"type":"string","enum":["CURR","EQUI","BOND","FTEQ","OPEQ","COMM","EMAL","OTHR"]},"FinancialInstrumentCreditDerivativeData":{"type":"object","properties":{"underlyingSwapIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"underlyingIndexIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"underlyingIndexName":{"type":"string","maxLength":25},"series":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"version":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"rollMonths":{"type":"array","items":{"type":"string","pattern":"^((0[1-9])|(1[012]))$","maxLength":255}},"nextRollDate":{"type":"string","format":"date"},"issuerSovereignPublic":{"type":"boolean","default":false},"referenceObligationIsin":{"type":"string","pattern":"^[A-Z]{2}[0-9A-Z]{9}[0-9]$","maxLength":255},"referenceEntityCountry":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":255},"referenceEntitySubDivision":{"type":"string","maxLength":6},"referenceEntityLei":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255},"referenceEntityNotionalCurrency":{"type":"string","pattern":"^[A-Z]{3}$","maxLength":255}}},"PublicIssuerData":{"type":"object","properties":{"companyName":{"type":"string","maxLength":255},"website":{"type":"string","maxLength":255},"legalAddress":{"$ref":"#/components/schemas/AddressData"},"legalEntityIdentifier":{"type":"string","pattern":"^[0-9A-Z]{18}[0-9]{2}$","maxLength":255}}},"AddressData":{"required":["countryCode","areaCode","city","street"],"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2},"areaCode":{"type":"string","maxLength":50},"city":{"type":"string","maxLength":50},"street":{"type":"string","maxLength":50},"postOfficeBox":{"type":"string","maxLength":50},"addressSupplement":{"type":"string","maxLength":255}}},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/tradingpairs/{id}":{"get":{"tags":["PublicMarketData"],"summary":"getTradingPair","description":"Anonymous endpoint that returns extended information on a trading pair\n","operationId":"getTradingPair","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradingPairPublicExtended"}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getPriceHistoryOhlc
> Anonymous endpoint that lists past prices of a trading pair in OHLC format
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"PriceOhlcItem":{"type":"object","properties":{"x":{"description":"Unix Timestamp\n","type":"integer","format":"int64","minimum":0},"o":{"description":"Opening price\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"h":{"description":"Highest price\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"l":{"description":"Lowest price\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"c":{"description":"Closing price\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255}}},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/tradingpairs/{id}/ohlc":{"get":{"tags":["PublicMarketData"],"summary":"getPriceHistoryOhlc","description":"Anonymous endpoint that lists past prices of a trading pair in OHLC format\n","operationId":"getPriceHistoryOhlc","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"starting","in":"query","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PriceOhlcItem"}}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getTradeInfo
> Anonymous endpoint that returns trade information for a trading pair
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"GlobalTradeInfoBase":{"type":"object","properties":{"lastPrice":{"description":"The price at which the last trade happened\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"referencePrice":{"description":"The reference price is set to the price at the close of the previous trading day. Used for pre-trade controls.\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"priceChange24h":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"tradeVolume24h":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"liquidityBand":{"description":"The liquidity band used to validate limit prices (tick size check)\n","type":"integer","format":"int32","minimum":0},"tradingStatus":{"description":"Status indicating if/how the trading pair can be used for trading\n","$ref":"#/components/schemas/TradingStatusEnum","readOnly":true},"statusChangeReason":{"description":"Reason why the last status change was made\n","$ref":"#/components/schemas/TradingStatusChangeReasonEnum","readOnly":true},"statusChangeReasonText":{"description":"Reason why the last status change was made (free text)\n","type":"string","readOnly":true,"maxLength":255},"tradingHaltCounter":{"description":"The number of trading halts that have occurred on the current trading day\n","type":"integer","format":"int32","minimum":0},"estimatedTradingHaltEnd":{"description":"If we are in a trading halt, the time when trading is expected to be resumed\n","type":"string","format":"date-time"}}},"TradingStatusEnum":{"type":"string","enum":["CREATED","CONTINUOUS_TRADING","OUT_OF_TRADING","AUTOMATIC_TRADING_HALT","MANUAL_TRADING_HALT","DISABLED","PERMANENTLY_DELETED"]},"TradingStatusChangeReasonEnum":{"type":"string","enum":["START_OF_TRADING_DAY","MANUAL_MARKET_OPEN","END_OF_TRADING_DAY","MANUAL_MARKET_CLOSE","REGULATOR_INITIATED_HALT","PARTICIPANT_INITIATED_HALT","VENUE_INITIATED_HALT","CAPACITY_LIMIT_HALT","VOLATILITY_HALT","TECHNICAL_HALT","TRADING_PAIR_ACTIVATION","TRADING_PAIR_DEACTIVATION","TRADING_PAIR_OFFBOARDING","TRADING_PAIR_CREATION","AUTOMATIC_RESUME"]},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/tradingpairs/{id}/tradeinfo":{"get":{"tags":["PublicMarketData"],"summary":"getTradeInfo","description":"Anonymous endpoint that returns trade information for a trading pair\n","operationId":"getTradeInfo","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GlobalTradeInfoBase"}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getOrderBookTopOrders
> Anonymous endpoint that fetches the first x open orders in the order book
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"OrderKindEnum":{"type":"string","enum":["BUY","SELL"]},"OrderBookResult":{"required":["tradingPairId"],"type":"object","properties":{"tradingPairId":{"type":"string","maxLength":255},"buy":{"type":"array","items":{"$ref":"#/components/schemas/OrderBookItemReduced"}},"sell":{"type":"array","items":{"$ref":"#/components/schemas/OrderBookItemReduced"}}}},"OrderBookItemReduced":{"required":["orderType","quantity"],"type":"object","properties":{"orderType":{"description":"The type of the order (currently only limit orders)\n","$ref":"#/components/schemas/OrderTypeEnum"},"quantity":{"description":"Remaining order size in financial instrument (base) tokens\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"limit":{"description":"The price limit of the order. Mandatory for limit orders\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255}}},"OrderTypeEnum":{"type":"string","enum":["LIMIT","MARKET"]},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/tradingpairs/{id}/orderbook":{"get":{"tags":["PublicMarketData"],"summary":"getOrderBookTopOrders","description":"Anonymous endpoint that fetches the first x open orders in the order book\n","operationId":"getOrderBookTopOrders","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"$ref":"#/components/schemas/OrderKindEnum"}},{"name":"max","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderBookResult"}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getOrderBookPriceLevels
> Anonymous endpoint that fetches the top x price levels and associated quantities in the order book
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"schemas":{"OrderKindEnum":{"type":"string","enum":["BUY","SELL"]},"OrderBookPriceLevelResult":{"required":["tradingPairId"],"type":"object","properties":{"tradingPairId":{"type":"string","maxLength":255},"buy":{"type":"array","items":{"$ref":"#/components/schemas/OrderBookPriceLevelItem"}},"sell":{"type":"array","items":{"$ref":"#/components/schemas/OrderBookPriceLevelItem"}}}},"OrderBookPriceLevelItem":{"required":["orderCount","totalQuantity"],"type":"object","properties":{"limit":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"orderCount":{"type":"integer","format":"int32","minimum":0},"totalQuantity":{"type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255}}},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/tradingpairs/{id}/pricelevels":{"get":{"tags":["PublicMarketData"],"summary":"getOrderBookPriceLevels","description":"Anonymous endpoint that fetches the top x price levels and associated quantities in the order book\n","operationId":"getOrderBookPriceLevels","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"$ref":"#/components/schemas/OrderKindEnum"}},{"name":"max","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderBookPriceLevelResult"}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
## getPostTradeTransparency
> Anonymous endpoint that fetches regulatory post-trade transparency data from the entire exchange, showing most recent trades first. If a trading pair ID is specified, the results are limited to trades related to that trading pair.
```json
{"openapi":"3.1.0","info":{"title":"EDX Public API Model","version":"1.0.0"},"tags":[{"name":"PublicMarketData"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"cursor":{"name":"cursor","description":"Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous response.\n","in":"query","required":false,"schema":{"type":"string"}},"limit":{"name":"limit","description":"The maximum number of items to return.\n","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},"count":{"name":"count","description":"Returns the total number of items in the collection.\n","in":"query","required":false,"schema":{"type":"boolean"}}},"schemas":{"PostTradeTransparencyDataList":{"required":["items"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PostTradeTransparencyData"}},"next_cursor":{"type":"string","maxLength":255},"total_count":{"type":"integer","format":"int64","minimum":0}}},"PostTradeTransparencyData":{"required":["tradingDateTime","instrumentIdentificationCodeType","instrumentIdentificationCode","price","priceCurrency","priceNotation","quantity","venueOfExecution","publicationDateTime","transactionIdentificationCode","notionalAmount"],"type":"object","properties":{"tradingDateTime":{"description":"Date and time of the finality of the transaction\n","type":"string","format":"date-time"},"instrumentIdentificationCodeType":{"description":"The type of the instrument identification code, e.g. 'ISIN'\n","type":"string","maxLength":255},"instrumentIdentificationCode":{"description":"The identification code of the financial instrument\n","type":"string","maxLength":255},"price":{"description":"The price at which the transaction was executed\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"priceCurrency":{"description":"Short code of the currency that the price is listed in\n","type":"string","maxLength":255},"priceNotation":{"description":"Usually 'MONE' for monetary value\n","type":"string","maxLength":255},"quantity":{"description":"The number of units of the financial instrument that were traded\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"venueOfExecution":{"description":"MIC of the trading venue, e.g. '21XX'\n","type":"string","maxLength":255},"publicationDateTime":{"description":"Date and time that the transaction was published\n","type":"string","format":"date-time"},"transactionIdentificationCode":{"description":"Alpha-numeric string uniquely identifying each transaction\n","type":"string","maxLength":255},"notionalAmount":{"description":"The total monetary value of the transaction (price*quantity)\n","type":"string","pattern":"^(-)?[0-9][0-9]*(?:.[0-9]{1,18})?$","maxLength":255},"notionalCurrency":{"description":"Short code of the currency that the notional amount is listed in\n","type":"string","maxLength":255}}},"AppError":{"required":["code","message"],"type":"object","properties":{"code":{"description":"A identifier that categorizes the error","type":"string"},"message":{"description":"A brief, human-readable message about the error","type":"string"},"status":{"description":"The HTTP response code","type":"integer","format":"int32"},"path":{"description":"A URI that identifies the specific occurrence of the error","type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Detailed explanations of the error","type":"array","items":{"type":"string"}}}}},"responses":{"DefaultError":{"description":"Unexpected error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppError"}}}}}},"paths":{"/posttrade/recent":{"get":{"tags":["PublicMarketData"],"summary":"getPostTradeTransparency","description":"Anonymous endpoint that fetches regulatory post-trade transparency data from the entire exchange, showing most recent trades first. If a trading pair ID is specified, the results are limited to trades related to that trading pair.\n","operationId":"getPostTradeTransparency","parameters":[{"name":"tradingpair","in":"query","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/count"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostTradeTransparencyDataList"}}}},"default":{"$ref":"#/components/responses/DefaultError"}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.21x.eu/api-reference-v1.0/publicmarketdata.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.