Get Prices from Venues

This workflow answers the question:

"For a given instrument (ex: BTC-USD), which venues support it — and what price does each venue currently show?”

Prerequisites

Base URL
• Production: https://md.checker.finance/api/v1

Authentication

All endpoints require an API key:

X-API-Key: <your-api-key>

Step 1) Get all venues that support a given currency pair (instrument)

Endpoint

GET /instruments/{symbol}/venues

This returns all venue mappings for a given instrument (ex: BTC-USD).

Example request

curl -s \
  -H "X-API-Key: $API_KEY" \
  "https://md.checker.finance/api/v1/instruments/BTC-USD/venues"

Example response

{
  "venue_instruments": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "venue_code": "COINBASE",
      "instrument_symbol": "BTC-USD",
      "venue_symbol": "BTC-USD",
      "is_inverse_available": true,
      "is_blacklisted": false,
      "is_active": true
    }
  ],
  "total": 1
}

Step 2) Loop through venues and fetch the price from each venue

Endpoint

GET /prices/{instrument}/venue/{venue}

This fetches the price for a given instrument from a specific venue.

Example request (single venue)

{
  "instrument_symbol": "BTC-USD",
  "venue_code": "COINBASE",
  "price": "42156.78",
  "timestamp": "2024-01-15T10:30:00Z",
  "source_method": "direct",
  "provenance": {
    "venue": "COINBASE",
    "method": "direct",
    "fetched_at": "2024-01-15T10:30:00Z",
    "cache_hit": true,
    "cache_layer": "redis"
  }
}

End-to-end example (pseudo-code)

INPUT: instrument_symbol = "BTC-USD"

1) Call GET /instruments/BTC-USD/venues
2) Extract venue_code list from venue_instruments[]
3) For each venue_code:
     Call GET /prices/BTC-USD/venue/{venue_code}
     Store results
4) Return list of venue prices