LogoLogo
  • Getting Started
  • How to Connect
  • REST API
    • Order
    • PublicMarketData
    • Wallet
    • Trade
    • Models
  • Smart Contract ABI
    • OrderBook
    • Order Data (explanation)
  • Websocket API
    • Orderbook
    • Ticker
  • SDK Documentation
    • Getting Started
    • REST API Interaction
    • Smart Contract Interaction
      • Order Placement
      • Order Cancelation
Powered by GitBook

Privacy

  • Privacy Policy

All rights reserved. 21X AG

On this page
Export as PDF
  1. REST API

PublicMarketData

PreviousOrderNextWallet

getFinancialInstruments

get

Anonymous endpoint that lists all financial instruments available for primary market trading

Authorizations
Query parameters
Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/financialinstruments HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "symbol": "text",
    "fullName": "text",
    "status": "CREATED",
    "isin": "text",
    "dti": "text",
    "issuerName": "text",
    "prospectusLink": "text",
    "effectiveDate": "2025-06-01T08:16:03.265Z",
    "terminationDate": "2025-06-01T08:16:03.265Z",
    "smartContractAddress": "text",
    "internalId": "text"
  }
]

getFinancialInstrument

get

Anonymous endpoint that returns extended information on a financial instrument

Authorizations
Path parameters
idstringRequired
Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/financialinstruments/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "status": "CREATED",
  "domicile": "text",
  "wkn": "text",
  "sedol": "text",
  "cusip": "text",
  "valor": "text",
  "dti": "text",
  "symbol": "text",
  "protocol": "POLYGON",
  "smartContractAddress": "text",
  "isin": "text",
  "fullName": "text",
  "cfi": "text",
  "commoditiesDerivativeIndicator": false,
  "issuerId": "text",
  "issuerName": "text",
  "tradingVenue": "21XX",
  "fisn": "text",
  "issuerRequestForAdmissionToTrade": false,
  "listingDate": "2025-06-01",
  "issuerApprovalDate": "2025-06-01T08:16:03.265Z",
  "admissionToTradeRequestDate": "2025-06-01T08:16:03.265Z",
  "effectiveDate": "2025-06-01T08:16:03.265Z",
  "terminationDate": "2025-06-01T08:16:03.265Z",
  "notionalCurrency1": "EUR",
  "mifirIdentifier": "SDRV",
  "numberOfOutstandingInstruments": "text",
  "holdingsExceedingTotalVotingRightThreshold": "text",
  "issuanceSize": "text",
  "assetClassOfUnderlying": "INTR",
  "maturityDate": "2025-06-01",
  "contractType": "OPTN",
  "linkedEntities": [
    {
      "entityType": "DISTRIBUTOR",
      "entityId": "text",
      "entityName": "text"
    }
  ],
  "availability": {
    "classification": [
      "RETAIL"
    ],
    "distribution": [
      "NATURAL_PERSON"
    ],
    "jurisdictions": [
      "text"
    ]
  },
  "displayData": {
    "assetType": "C_COLLECTIVE_INVESTMENT_VEHICLES",
    "subAssetType": "C_I",
    "prospectusLink": "text",
    "description": "text",
    "replication": "text",
    "investmentStyle": "text",
    "useOfIncome": "ACCUMULATING",
    "instrumentName": "text",
    "instrumentNickname": "text",
    "underlyingInstrumentName": "text",
    "underlyingInstrumentNickname": "text",
    "linkToUnderlying": "text"
  },
  "performanceData": {
    "nav": "text",
    "navCurrency": "text",
    "navLastUpdate": "2025-06-01",
    "navSource": "text",
    "totalExpenseRatio": "text",
    "assetsUnderManagement": "text",
    "assetsUnderManagementCurrency": "text",
    "assetsUnderManagementLastUpdate": "2025-06-01"
  },
  "debtInstrumentData": {
    "totalIssuedNominalAmount": "text",
    "maturityDate": "2025-06-01",
    "currency": "text",
    "minimumTradedValue": "text",
    "fixedRate": "text",
    "bondSeniority": "SNDB",
    "bondType": "EUSB",
    "bondIssuanceDate": "2025-06-01",
    "indexBenchmark": {
      "isin": "text",
      "index": "OTHR",
      "indexName": "text",
      "indexTermUnit": "DAYS",
      "indexTermValue": 1,
      "basePointSpread": 1
    }
  },
  "derivativeData": {
    "expiryDate": "2025-06-01",
    "priceMultiplier": "text",
    "optionType": "PUTO",
    "strikePriceType": "MONE",
    "strikePriceValue": "text",
    "strikePriceCurrency": "text",
    "optionExerciseStyle": "EURO",
    "deliveryType": "PHYS",
    "equityDerivativeUnderlyingType": "STIX",
    "equityDerivativeParameter": "PRBP",
    "underlyingInstruments": [
      {
        "isin": "text",
        "issuerLei": "text",
        "index": "OTHR",
        "indexName": "text",
        "indexTermUnit": "DAYS",
        "indexTermValue": 1
      }
    ]
  },
  "commodityDerivativeData": {
    "baseProduct": "AGRI",
    "subProduct": "GROS",
    "furtherSubProduct": "FWHT",
    "transactionType": "FUTR",
    "finalPriceType": "ARGM",
    "sizeSpecification": "CAPE",
    "freightRoute": "text",
    "settlementLocation": "text",
    "commodityNotionalCurrency": "text",
    "emissionAllowanceSubType": "CERE"
  },
  "interestRateDerivativeData": {
    "referenceRateIndex": "OTHR",
    "referenceRateName": "text",
    "interestRateTermUnit": "DAYS",
    "interestRateTermValue": 1,
    "notionalCurrency2": "text",
    "fixedRateLeg1": "text",
    "fixedRateLeg2": "text",
    "floatingRateLeg2Index": "OTHR",
    "floatingRateLeg2Name": "text",
    "interestRateLeg2TermUnit": "DAYS",
    "interestRateLeg2TermValue": 1,
    "underlyingInterestRateDerivativeType": "BOND",
    "underlyingInterestRateDerivativeIsin": "text",
    "underlyingInterestRateDerivativeIndexName": "text",
    "underlyingInterestRateDerivativeReferenceRateIndex": "OTHR",
    "underlyingInterestRateDerivativeReferenceRateName": "text",
    "underlyingInterestRateDerivativeTermUnit": "DAYS",
    "underlyingInterestRateDerivativeTermValue": 1,
    "underlyingInterestRateDerivativeBond": {
      "issuerLei": "text",
      "maturityDate": "2025-06-01",
      "issuanceDate": "2025-06-01"
    },
    "underlyingInterestRateDerivativeSwap": {
      "notionalCurrency": "text",
      "maturityDate": "2025-06-01"
    }
  },
  "foreignExchangeDerivativeData": {
    "notionalCurrency2": "text",
    "foreignExchangeType": "FXCR",
    "foreignExchangeContractSubType": "DLVB"
  },
  "emissionAllowanceData": {
    "subType": "CERE"
  },
  "contractsForDifferenceData": {
    "underlyingType": "CURR",
    "notionalCurrency1": "text",
    "notionalCurrency2": "text"
  },
  "creditDerivativeData": {
    "underlyingSwapIsin": "text",
    "underlyingIndexIsin": "text",
    "underlyingIndexName": "text",
    "series": "text",
    "version": "text",
    "rollMonths": [
      "text"
    ],
    "nextRollDate": "2025-06-01",
    "issuerSovereignPublic": false,
    "referenceObligationIsin": "text",
    "referenceEntityCountry": "text",
    "referenceEntitySubDivision": "text",
    "referenceEntityLei": "text",
    "referenceEntityNotionalCurrency": "text"
  },
  "internalId": "text",
  "issuerData": {
    "companyName": "text",
    "website": "text",
    "legalAddress": {
      "countryCode": "text",
      "areaCode": "text",
      "city": "text",
      "street": "text",
      "postOfficeBox": "text",
      "addressSupplement": "text"
    },
    "legalEntityIdentifier": "text"
  }
}

getTradingPairs

get

Anonymous endpoint that lists all available trading pairs

Authorizations
Query parameters
cursorstringOptional

Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous response.

limitinteger · int64Optional

The maximum number of items to return.

countbooleanOptional

Returns the total number of items in the collection.

Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/tradingpairs HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "items": [
    {
      "id": "text",
      "creationDate": "2025-06-01T08:16:03.265Z",
      "modificationDate": "2025-06-01T08:16:03.265Z",
      "quoteTokenSymbol": "text",
      "minimumSizeIncrement": "text",
      "priceCollarFactor": 1,
      "maximumMatches": 1,
      "staticThreshold": 1,
      "dynamicThreshold": 1,
      "liquidityBand": 1,
      "blockChain": "POLYGON",
      "smartContractOrderBook": "text",
      "smartContractBase": "text",
      "smartContractQuote": "text",
      "makerCommission": 1,
      "takerCommission": 1,
      "marketMakerCommission": 1,
      "baseTokenNativeScale": "text",
      "quoteTokenNativeScale": "text",
      "tradingStatus": "OUT_OF_TRADING",
      "orderBookVersion": "text",
      "statusChangeReason": "START_OF_TRADING_DAY",
      "statusChangeReasonText": "text",
      "baseTokenInternalScale": "text",
      "quoteTokenInternalScale": "text",
      "quoteTokenEquivalentCurrency": "text",
      "staticReferencePrice": "text",
      "minimumOrderValue": "text",
      "maximumOrderValue": "text",
      "baseTokenData": {
        "symbol": "text",
        "fullName": "text",
        "status": "CREATED",
        "isin": "text",
        "dti": "text",
        "issuerName": "text",
        "prospectusLink": "text",
        "effectiveDate": "2025-06-01T08:16:03.265Z",
        "terminationDate": "2025-06-01T08:16:03.265Z",
        "smartContractAddress": "text"
      }
    }
  ],
  "next_cursor": "text",
  "total_count": 1
}

getTradingPair

get

Anonymous endpoint that returns extended information on a trading pair

Authorizations
Path parameters
idstringRequired
Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/tradingpairs/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "creationDate": "2025-06-01T08:16:03.265Z",
  "modificationDate": "2025-06-01T08:16:03.265Z",
  "quoteTokenSymbol": "text",
  "minimumSizeIncrement": "text",
  "priceCollarFactor": 1,
  "maximumMatches": 1,
  "staticThreshold": 1,
  "dynamicThreshold": 1,
  "liquidityBand": 1,
  "blockChain": "POLYGON",
  "smartContractOrderBook": "text",
  "smartContractBase": "text",
  "smartContractQuote": "text",
  "makerCommission": 1,
  "takerCommission": 1,
  "marketMakerCommission": 1,
  "baseTokenNativeScale": "text",
  "quoteTokenNativeScale": "text",
  "tradingStatus": "OUT_OF_TRADING",
  "orderBookVersion": "text",
  "statusChangeReason": "START_OF_TRADING_DAY",
  "statusChangeReasonText": "text",
  "baseTokenInternalScale": "text",
  "quoteTokenInternalScale": "text",
  "quoteTokenEquivalentCurrency": "text",
  "staticReferencePrice": "text",
  "minimumOrderValue": "text",
  "maximumOrderValue": "text",
  "baseTokenData": {
    "status": "CREATED",
    "domicile": "text",
    "wkn": "text",
    "sedol": "text",
    "cusip": "text",
    "valor": "text",
    "dti": "text",
    "symbol": "text",
    "protocol": "POLYGON",
    "smartContractAddress": "text",
    "isin": "text",
    "fullName": "text",
    "cfi": "text",
    "commoditiesDerivativeIndicator": false,
    "issuerId": "text",
    "issuerName": "text",
    "tradingVenue": "21XX",
    "fisn": "text",
    "issuerRequestForAdmissionToTrade": false,
    "listingDate": "2025-06-01",
    "issuerApprovalDate": "2025-06-01T08:16:03.265Z",
    "admissionToTradeRequestDate": "2025-06-01T08:16:03.265Z",
    "effectiveDate": "2025-06-01T08:16:03.265Z",
    "terminationDate": "2025-06-01T08:16:03.265Z",
    "notionalCurrency1": "EUR",
    "mifirIdentifier": "SDRV",
    "numberOfOutstandingInstruments": "text",
    "holdingsExceedingTotalVotingRightThreshold": "text",
    "issuanceSize": "text",
    "assetClassOfUnderlying": "INTR",
    "maturityDate": "2025-06-01",
    "contractType": "OPTN",
    "linkedEntities": [
      {
        "entityType": "DISTRIBUTOR",
        "entityId": "text",
        "entityName": "text"
      }
    ],
    "availability": {
      "classification": [
        "RETAIL"
      ],
      "distribution": [
        "NATURAL_PERSON"
      ],
      "jurisdictions": [
        "text"
      ]
    },
    "displayData": {
      "assetType": "C_COLLECTIVE_INVESTMENT_VEHICLES",
      "subAssetType": "C_I",
      "prospectusLink": "text",
      "description": "text",
      "replication": "text",
      "investmentStyle": "text",
      "useOfIncome": "ACCUMULATING",
      "instrumentName": "text",
      "instrumentNickname": "text",
      "underlyingInstrumentName": "text",
      "underlyingInstrumentNickname": "text",
      "linkToUnderlying": "text"
    },
    "performanceData": {
      "nav": "text",
      "navCurrency": "text",
      "navLastUpdate": "2025-06-01",
      "navSource": "text",
      "totalExpenseRatio": "text",
      "assetsUnderManagement": "text",
      "assetsUnderManagementCurrency": "text",
      "assetsUnderManagementLastUpdate": "2025-06-01"
    },
    "debtInstrumentData": {
      "totalIssuedNominalAmount": "text",
      "maturityDate": "2025-06-01",
      "currency": "text",
      "minimumTradedValue": "text",
      "fixedRate": "text",
      "bondSeniority": "SNDB",
      "bondType": "EUSB",
      "bondIssuanceDate": "2025-06-01",
      "indexBenchmark": {
        "isin": "text",
        "index": "OTHR",
        "indexName": "text",
        "indexTermUnit": "DAYS",
        "indexTermValue": 1,
        "basePointSpread": 1
      }
    },
    "derivativeData": {
      "expiryDate": "2025-06-01",
      "priceMultiplier": "text",
      "optionType": "PUTO",
      "strikePriceType": "MONE",
      "strikePriceValue": "text",
      "strikePriceCurrency": "text",
      "optionExerciseStyle": "EURO",
      "deliveryType": "PHYS",
      "equityDerivativeUnderlyingType": "STIX",
      "equityDerivativeParameter": "PRBP",
      "underlyingInstruments": [
        {
          "isin": "text",
          "issuerLei": "text",
          "index": "OTHR",
          "indexName": "text",
          "indexTermUnit": "DAYS",
          "indexTermValue": 1
        }
      ]
    },
    "commodityDerivativeData": {
      "baseProduct": "AGRI",
      "subProduct": "GROS",
      "furtherSubProduct": "FWHT",
      "transactionType": "FUTR",
      "finalPriceType": "ARGM",
      "sizeSpecification": "CAPE",
      "freightRoute": "text",
      "settlementLocation": "text",
      "commodityNotionalCurrency": "text",
      "emissionAllowanceSubType": "CERE"
    },
    "interestRateDerivativeData": {
      "referenceRateIndex": "OTHR",
      "referenceRateName": "text",
      "interestRateTermUnit": "DAYS",
      "interestRateTermValue": 1,
      "notionalCurrency2": "text",
      "fixedRateLeg1": "text",
      "fixedRateLeg2": "text",
      "floatingRateLeg2Index": "OTHR",
      "floatingRateLeg2Name": "text",
      "interestRateLeg2TermUnit": "DAYS",
      "interestRateLeg2TermValue": 1,
      "underlyingInterestRateDerivativeType": "BOND",
      "underlyingInterestRateDerivativeIsin": "text",
      "underlyingInterestRateDerivativeIndexName": "text",
      "underlyingInterestRateDerivativeReferenceRateIndex": "OTHR",
      "underlyingInterestRateDerivativeReferenceRateName": "text",
      "underlyingInterestRateDerivativeTermUnit": "DAYS",
      "underlyingInterestRateDerivativeTermValue": 1,
      "underlyingInterestRateDerivativeBond": {
        "issuerLei": "text",
        "maturityDate": "2025-06-01",
        "issuanceDate": "2025-06-01"
      },
      "underlyingInterestRateDerivativeSwap": {
        "notionalCurrency": "text",
        "maturityDate": "2025-06-01"
      }
    },
    "foreignExchangeDerivativeData": {
      "notionalCurrency2": "text",
      "foreignExchangeType": "FXCR",
      "foreignExchangeContractSubType": "DLVB"
    },
    "emissionAllowanceData": {
      "subType": "CERE"
    },
    "contractsForDifferenceData": {
      "underlyingType": "CURR",
      "notionalCurrency1": "text",
      "notionalCurrency2": "text"
    },
    "creditDerivativeData": {
      "underlyingSwapIsin": "text",
      "underlyingIndexIsin": "text",
      "underlyingIndexName": "text",
      "series": "text",
      "version": "text",
      "rollMonths": [
        "text"
      ],
      "nextRollDate": "2025-06-01",
      "issuerSovereignPublic": false,
      "referenceObligationIsin": "text",
      "referenceEntityCountry": "text",
      "referenceEntitySubDivision": "text",
      "referenceEntityLei": "text",
      "referenceEntityNotionalCurrency": "text"
    },
    "internalId": "text",
    "issuerData": {
      "companyName": "text",
      "website": "text",
      "legalAddress": {
        "countryCode": "text",
        "areaCode": "text",
        "city": "text",
        "street": "text",
        "postOfficeBox": "text",
        "addressSupplement": "text"
      },
      "legalEntityIdentifier": "text"
    }
  }
}

getPriceHistoryOhlc

get

Anonymous endpoint that lists past prices of a trading pair in OHLC format

Authorizations
Path parameters
idstringRequired
Query parameters
intervalinteger · int32Optional
startinginteger · int64Optional
Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/tradingpairs/{id}/ohlc HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "x": 1,
    "o": "text",
    "h": "text",
    "l": "text",
    "c": "text"
  }
]

getTradeInfo

get

Anonymous endpoint that returns trade information for a trading pair

Authorizations
Path parameters
idstringRequired
Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/tradingpairs/{id}/tradeinfo HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "lastPrice": "text",
  "referencePrice": "text",
  "priceChange24h": "text",
  "tradeVolume24h": "text",
  "liquidityBand": 1,
  "tradingStatus": "CREATED",
  "statusChangeReason": "START_OF_TRADING_DAY",
  "statusChangeReasonText": "text",
  "tradingHaltCounter": 1,
  "estimatedTradingHaltEnd": "2025-06-01T08:16:03.265Z"
}

getOrderBookTopOrders

get

Anonymous endpoint that fetches the first x open orders in the order book

Authorizations
Path parameters
idstringRequired
Query parameters
kindstring · enumOptionalPossible values:
maxinteger · int32Optional
Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/tradingpairs/{id}/orderbook HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "tradingPairId": "text",
  "buy": [
    {
      "orderType": "LIMIT",
      "quantity": "text",
      "limit": "text"
    }
  ],
  "sell": [
    {
      "orderType": "LIMIT",
      "quantity": "text",
      "limit": "text"
    }
  ]
}

getOrderBookPriceLevels

get

Anonymous endpoint that fetches the top x price levels and associated quantities in the order book

Authorizations
Path parameters
idstringRequired
Query parameters
kindstring · enumOptionalPossible values:
maxinteger · int32Optional
Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/tradingpairs/{id}/pricelevels HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "tradingPairId": "text",
  "buy": [
    {
      "limit": "text",
      "orderCount": 1,
      "totalQuantity": "text"
    }
  ],
  "sell": [
    {
      "limit": "text",
      "orderCount": 1,
      "totalQuantity": "text"
    }
  ]
}

getPostTradeTransparency

get

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.

Authorizations
Query parameters
tradingpairstringOptional
cursorstringOptional

Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous response.

limitinteger · int64Optional

The maximum number of items to return.

countbooleanOptional

Returns the total number of items in the collection.

Responses
200
OK
application/json
default
Unexpected error
application/json
get
GET /api/v1/posttrade/recent HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "items": [
    {
      "tradingDateTime": "2025-06-01T08:16:03.265Z",
      "instrumentIdentificationCodeType": "text",
      "instrumentIdentificationCode": "text",
      "price": "text",
      "priceCurrency": "text",
      "priceNotation": "text",
      "quantity": "text",
      "venueOfExecution": "text",
      "publicationDateTime": "2025-06-01T08:16:03.265Z",
      "transactionIdentificationCode": "text",
      "notionalAmount": "text",
      "notionalCurrency": "text"
    }
  ],
  "next_cursor": "text",
  "total_count": 1
}
  • GETgetFinancialInstruments
  • GETgetFinancialInstrument
  • GETgetTradingPairs
  • GETgetTradingPair
  • GETgetPriceHistoryOhlc
  • GETgetTradeInfo
  • GETgetOrderBookTopOrders
  • GETgetOrderBookPriceLevels
  • GETgetPostTradeTransparency