CME GC Allocator API - Message Specification - Search Collateral

Request one ore more collateral allocations and/or substitutions using custom search criteria. Results will be limited to active trades, and trades that have ended within the last 7 calendar days.

URL

/collateral/search

HTTP Method

GET

Version

1.0.30

Content

 

 

 

Request

Parameters

Parameter

Name

Location

Type

Multi-ple

Values

Usage

Description

Parameter

Name

Location

Type

Multi-ple

Values

Usage

Description

CME-Application-Name

Application Name

Header

String

No

 

REQUIRED

Name of the customer system that generated the message. Must match the system name as certified in AutoCert+ exactly.

CME-Application-Vendor

Application Vendor

Header

String

No

 

REQUIRED

Name of the vendor who provided the customer system. For a proprietary system, use the firm name.

CME-Application-Version

Application Version

Header

String

No

 

REQUIRED

Version identifier for the customer system.

CME-Request-ID

Request ID

Header

String

No

 

REQUIRED

Identifier for the customer message.

CME-Transact-Time

Transaction Time

Header

DateTime

No

Format:  yyyy-mm-ddThh:mm:ss.dZ

OPTIONAL

Timestamp of when the message was sent from customer system.

collateralGuid

Collateral GUID

Query

String

No

 

OPTIONAL

 

endLastUpdateTime

End Last Update Time

Query

DateTime

No

Format:  yyyy-mm-ddThh:mm:ss.dZ

OPTIONAL

 

endSubstitutionsRemainingCnt

End Substitutions Remaining Count

Query

Integer

No

 

OPTIONAL

 

endTransactionTime

End Transaction Time

Query

DateTime

No

Format:  yyyy-mm-ddThh:mm:ss.dZ

OPTIONAL

 

generalCollateralInstrumentCusip

General Collateral Instrument CUSIP

Query

String

No

 

OPTIONAL

 

generalCollateralInstrumentExchangeId

Exchange ID

Query

String

No

 

OPTIONAL

 

generalCollateralInstrumentGuid

General Collateral Instrument GUID

Query

String

No

 

OPTIONAL

 

generalCollateralInstrumentIsin

General Collateral Instrument ISIN

Query

String

No

 

OPTIONAL

 

instrumentCusip

Instrument CUSIP

Query

String

No

 

OPTIONAL

 

instrumentGuid

Instrument GUID

Query

String

No

 

OPTIONAL

 

instrumentIsin

Instrument ISIN

Query

String

No

 

OPTIONAL

 

originalCollateralGuid

Original Collateral GUID

Query

String

No

 

OPTIONAL

 

sideGuid

Side GUID

Query

String

No

 

OPTIONAL

 

startLastUpdateTime

Start Last Update Time

Query

DateTime

No

Format:  yyyy-mm-ddThh:mm:ss.dZ

OPTIONAL

 

startSubstitutionsRemainingCnt

Start Substitutions Remaining Count

Query

Integer

No

 

OPTIONAL

 

startTransactionTime

Start Transaction Time

Query

DateTime

No

Format:  yyyy-mm-ddThh:mm:ss.dZ

OPTIONAL

 

Status

Collateral Status

Query

CollateralStatus

No

  • ACTIVE

  • CANCELED

  • SUBSTITUTED

OPTIONAL

 

substitutionInd

Substitution Indicator

Query

SubstitutionIndicator

No

  • ORIGINAL

  • REMAINDER

  • SUBSTITUTION

OPTIONAL

 

Response - 200

Body

Collateral Response Message - CollateralResponseMessage

Field

Name

Type

Values

Usage

Description

Field

Name

Type

Values

Usage

Description

payload[]

Payload

Collateral

 

 

 

Collateral - CollateralResponseMessage.payload[]

Field

Name

Type

Values

Usage

Description

Field

Name

Type

Values

Usage

Description

accruedInterestAmt

Accrued Interest Amount

Decimal

 

CONDITIONAL

  • Always when  Status = SUBSTITUTED

cleanPrice

Clean Price

Price

 

ALWAYS

 

collateralGuid

Collateral GUID

String

 

ALWAYS

 

dealId

Deal ID

String

 

ALWAYS

 

dirtyPrice

Dirty Price

Price

 

ALWAYS

 

endCash

End Cash

Decimal

 

CONDITIONAL

 

Not present for EONIA repos.

 

lastUpdateTime

Last Update Time

DateTime

Format:  yyyy-mm-ddThh:mm:ss.dZ

ALWAYS

 

notificationQty

Notification Quantity

Integer

 

CONDITIONAL

 

Aggregate quantity of all remaining, unfilled notifications on this allocation

 

  • Always when  NotificationQuantity <> 0

originalCollateralGuid

Original Collateral GUID

String

 

CONDITIONAL

  • Always when  SubstitutionIndicator = SUBSTITUTION

  • Always when  SubstitutionIndicator = REMAINDER

originalTransactionTime

Original Transaction Time

DateTime

Format:  yyyy-mm-ddThh:mm:ss.dZ

ALWAYS

 

originalVenueCollateralNbr

Original Venue Collateral Number

String

 

CONDITIONAL

  • Always when  SubstitutionIndicator = SUBSTITUTION

  • Always when  SubstitutionIndicator = REMAINDER

qty

Quantity

Quantity

 

ALWAYS

 

sideGuid

Side GUID

String

 

ALWAYS

 

sideInd

Side Indicator

MarketSideIndicator

  • BUY

  • SELL

ALWAYS

 

startCash

Start Cash

Decimal

 

ALWAYS

 

status

Collateral Status

CollateralStatus

  • ACTIVE

  • CANCELED

  • SUBSTITUTED

ALWAYS

 

substitutionInd

Substitution Indicator

SubstitutionIndicator

  • ORIGINAL

  • REMAINDER

  • SUBSTITUTION

ALWAYS

 

substitutionsRemainingCnt

Substitutions Remaining Count

Integer

 

ALWAYS

 

tradeId

Trade ID

String

 

ALWAYS

 

transactionTime

Transaction Time

DateTime

Format:  yyyy-mm-ddThh:mm:ss.dZ

ALWAYS

 

venueCollateralNbr

Venue Collateral ID

String

 

ALWAYS

 

entities

Entities

TradeSideEntities

 

 

 

generalCollateralInstrument

General Collateral Instrument

Instrument

 

 

 

instrument

Instrument

Instrument

 

 

 

Trade Side Entities - CollateralResponseMessage.payload[].entities

Field

Name

Type

Values

Usage

Description

Field

Name

Type

Values

Usage

Description

enteringTraderId

Entering Trader ID

String

 

ALWAYS

 

executingFirmId

Executing Firm ID

String

 

ALWAYS

 

oppositeFirmId

Opposite Firm ID

String

 

CONDITIONAL

  • Always when  BilateralIndicator = YES

Instrument - CollateralResponseMessage.payload[].generalCollateralInstrument

Field

Name

Type

Values

Usage

Description

Field

Name

Type

Values

Usage

Description

clearingOrganizationId

Clearing Organization ID

String

 

CONDITIONAL

  • Always when  BilateralIndicator = NO

cusip

CUSIP

String

 

CONDITIONAL

 

Only present on US securities.

 

exchangeId

Exchange ID

String

 

ALWAYS

 

guid

GUID

String

 

ALWAYS

 

isin

ISIN

String

 

CONDITIONAL

 

Only present on non-US securities.

 

longName

LongName

String

 

ALWAYS

 

priceSource

Price Source

PriceSource

  • CLEAN

  • DIRTY

ALWAYS

 

Price applied for the cash flow valuation

 

symbol

Symbol

String

 

ALWAYS

 

Instrument - CollateralResponseMessage.payload[].instrument

Field

Name

Type

Values

Usage

Description

Field

Name

Type

Values

Usage

Description

cusip

CUSIP

String

 

CONDITIONAL

 

Only present on US securities.

 

guid

GUID

String

 

ALWAYS

 

isin

ISIN

String

 

CONDITIONAL

 

Only present on non-US securities.

 

longName

Long Name

String

 

ALWAYS

 

productType

Product Type

ProductType

  • BOND

  • EUSOV

  • EUSUP

  • TB

  • TBA

  • TINT

  • TIPS

  • SOV

  • SUPRA

  • TBILL

  • TBOND

  • TNOTE

ALWAYS

 

Response - 400

Body

Error Response Message - ErrorResponseMessage

Field 

Name

Type 

Values 

Usage 

Description

Field 

Name

Type 

Values 

Usage 

Description

errors[]

Errors

Error

 

Error - ErrorResponseMessage.errors[]

Field

Name

Type

Values

Usage

Description

Field

Name

Type

Values

Usage

Description

code

Code

String

 

ALWAYS

 

instance

Instance

String

 

OPTIONAL

 

message

Message

String

 

ALWAYS

 

referenceIndex

Reference Index

Integer

 

ALWAYS

 

Response - 401

Response - 404




How was your Client Systems Wiki Experience? Submit Feedback

Copyright © 2024 CME Group Inc. All rights reserved.