API Coinbase

Coinbase

 

지원되는 API

 

 

Most common uses

 

WebSockets API

WebSocket 피드는 공개적으로 사용 가능하며 주문 및 거래에 대한 실시간 시장 데이터 업데이트를 제공합니다. 프로덕션에서 두 개의 엔드포인트가 지원됩니다:

 

 

다음 채널을 구독할 수 있습니다:

 

메서드 Arguments 설명
SubscribeHeartBeat   모든 연결을 열린 상태로 유지하기 위한 실시간 서버 ping
SubscribeStatus aProductId: 제품의 id입니다 미리 설정된 간격으로 모든 상품과 통화를 전송합니다
SubscribeCandles aProductId: 제품의 id입니다 product candle에 대한 실시간 업데이트
SubscribeTicker aProductId: 제품의 id입니다 매칭이 발생할 때마다 실시간 가격 업데이트
SubscribeTickerBatch aProductId: 제품의 id입니다 5000밀리초마다 실시간 가격 업데이트
SubscribeLevel2 aProductId: 제품의 id입니다 모든 업데이트 및 주문 장부 스냅샷을 유지하는 가장 쉬운 방법
SubscribeMarketTrades aProductId: 제품의 id입니다 시장 거래가 발생할 때마다 실시간 업데이트
SubscribeUser aProductId: 제품의 id입니다 인증된 사용자를 포함하는 메시지만 전송합니다
SubscribeFuturesBalanceSummary   사용자의 선물 잔액이 변경될 때마다 실시간 업데이트

 

User 및 FuturesBalanceSummary 채널에는 인증이 필요하므로, 먼저 Coinbase 계정에서 API 키를 요청한 다음 구성 요소의 Coinbase 속성에 값을 설정하십시오:

 

 

인증은 다음과 같은 몇 가지 이점을 제공합니다.

  1. 당사자 중 한 명인 메시지는 확장되며 더 유용한 필드를 가집니다
  2. 귀하가 넣은 stop order에 대한 lifecycle 정보와 같은 비공개 메시지를 받게 됩니다

 

 

 

REST API

Private Endpoints

프라이빗 엔드포인트는 주문 관리 및 계정 관리에 사용할 수 있습니다.

요청에 서명할 수 있으려면 먼저 Coinbase Pro 웹사이트를 통해 API 키를 생성해야 합니다. API 키는 특정 프로필로 범위가 지정됩니다. 키를 생성하면 반드시 기억해야 하는 3개의 정보를 얻게 됩니다:

 

 

Key와 Secret은 무작위로 생성되어 Coinbase Pro에서 제공됩니다. Passphrase는 API 액세스를 더욱 안전하게 하기 위해 사용자가 제공합니다. Coinbase Pro는 검증을 위해 passphrase의 솔트된 해시를 저장하지만, 잊어버린 경우 passphrase를 복구할 수 없습니다.

 

API 키의 기능을 제한할 수 있습니다. 키를 생성하기 전에 키가 가질 권한을 선택해야 합니다. 권한은 다음과 같습니다:

 

 

Accounts

 

메서드 Arguments Description
ListAccounts   API 키의 프로필에서 거래 계정 목록을 가져옵니다.
GetAccount aAccountId: 계정의 id 단일 계정에 대한 정보. account_id를 알고 있을 때 이 엔드포인트를 사용하십시오. API 키는 계정과 동일한 프로필에 속해야 합니다.

 

Orders

 

메서드 Arguments Description
PlaceNewOrder aOrder: 주문의 가능한 모든 필드를 포함하는 클래스 새 주문을 배치합니다. 고급 주문 옵션에 액세스해야 하는 경우에만 사용하십시오.
PlaceMarketOrder

aSide: buy 또는 sell

aProductId: 제품의 id

aQuoteSize: Trading Pair의 두 번째 Asset의 양입니다.

aBaseSize: 거래 페어에서 첫 번째 Asset의 수량

aClient_oid: 주문을 식별하기 위해 사용자가 선택한 Order ID

새 Market 주문을 넣습니다.
PlaceLimitOrder

aSide: buy 또는 sell

aProductId: 제품의 id

aQuoteSize: Trading Pair에서 두 번째 Asset의 수량입니다.

aBaseSize: Trading Pair에서 첫 번째 Asset의 양

aLimitPrice: 가격 한도

Client_oid: 주문을 식별하기 위해 직접 선택한 주문 ID

새 Limit 주문을 배치합니다.
PlaceStopOrder

aSide: buy 또는 sell

ProductId: 제품의 id

aBaseSize: Trading Pair에서 첫 번째 Asset의 양

StopPrice: stop의 가격

aLimitPrice: 가격 한도

aStopDirection: loss 또는 entry

Client_oid: 주문을 식별하기 위해 선택한 Order ID

새 Stop Order를 합니다
CancelOrder aOrderId: 주문의 id 이전에 넣은 주문을 취소합니다. 주문은 API 키가 속한 프로필에 속해야 합니다.
EditOrder

aOrderId: 주문의 id

aPrice: 가격

aSize: 수량

지정된 새 크기 또는 새 가격으로 주문을 편집합니다
EditOrderPreview

aOrderId: 주문의 id

aPrice: 가격

aSize: 수량

지정된 새 크기 또는 새 가격으로 주문 편집 요청을 미리 봅니다.
ListOrders   선택적 쿼리 매개변수(product_id, order_status 등)로 필터링된 주문 목록을 가져옵니다.
GetOrder aOrderId: 주문의 id 주문 ID로 단일 주문을 가져옵니다.
PreviewOrder   주문을 미리 봅니다.
ClosePosition

aOrderId: 주문의 id

aProductId: 제품의 id

aSize: 수량

지정된 product_id에 대한 모든 미체결 포지션을 청산하는 주문을 실행합니다.

 

 

 

 

Market Data

 

메서드 Arguments Description
GetPublicProducts   거래에 사용 가능한 통화 쌍 목록을 가져옵니다.
GetPublicProduct

aProductId: 제품의 id

product ID로 단일 상품에 대한 정보를 가져옵니다.
GetPublicProductBook aProductId: 상품의 id입니다. 단일 product에 대한 매수/매도 목록을 가져옵니다. 표시되는 세부 정보의 양은 limit 매개변수로 사용자 지정할 수 있습니다.
GetPublicProductCandles

aProductId: 상품의 id입니다.

aStart: 시간 간격의 시작입니다.

aEnd: 시간 간격의 끝

aGranularity: 각 candle이 나타내는 시간 프레임입니다.

제품 ID로 단일 제품의 요율을 버킷으로 그룹화하여 가져옵니다.
GetTrades aProductId: 상품의 id입니다. 제품 ID로 최근 거래(틱)와 최우선 매수/매도 호가에 대한 스냅샷 정보를 가져옵니다.
GetTime

 

Coinbase Advanced API에서 현재 시간을 가져옵니다.

 

 

Fills

 

메서드 Arguments Description
GetFillsByOrderId   주문 id로 필터링된 체결 목록을 가져옵니다
GetFillsByProductId

 

product id로 필터링된 체결 목록을 가져옵니다
GetFillsByTradeId   trade id로 필터링된 fills 목록을 가져옵니다

Convert

메서드 Arguments Description
CreateConvertQuote 통화 간 환전 견적을 생성합니다.
CommitConvertTrade convert 거래를 commit합니다.
GetConvertTrade convert 거래 세부 정보를 가져옵니다.

Fees

메서드 Arguments Description
GetTransactionSummary 거래 수수료 요약을 가져옵니다.

Products (인증됨)

메서드 Arguments Description
ListProducts 사용 가능한 product를 나열합니다.
GetProduct aProductId: 제품의 id입니다 특정 제품을 가져옵니다.
GetProductBook aProductId: 제품의 id입니다 상품 주문서를 가져옵니다.
GetProductCandles aProductId: 제품의 id입니다 상품 OHLCV 캔들을 가져옵니다.
GetMarketTrades aProductId: 제품의 id입니다 최근 시장 거래를 가져옵니다.
GetBestBidAsk 최우선 매수/매도 가격을 가져옵니다.

Portfolios

메서드 Arguments Description
ListPortfolios 모든 포트폴리오를 나열합니다.
CreatePortfolio 새 포트폴리오를 생성합니다.
DeletePortfolio 포트폴리오를 삭제합니다.
GetPortfolioBreakdown 포트폴리오 분석 세부 정보를 가져옵니다.
MovePortfolioFunds 포트폴리오 간에 자금을 이동합니다.

Perpetuals

메서드 Arguments Description
GetPerpetualsPortfolioSummary perpetuals 포트폴리오 요약을 가져옵니다.
ListPerpetualsPositions 무기한 포지션을 나열합니다.
GetPerpetualsPosition 특정 perpetuals 포지션을 가져옵니다.