{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"c79d11a0-f6ec-4f84-b7e6-3b7b21e73d56","name":"BLOCKSDK API (V3)","description":"API 서비스는 8월31일까지 지원되며 9월1일 부터는 지원종료될 예정입니다.\n\n# 소개\n\nBLOCKSDK 개발자 문서에 오신 것을 환영합니다!\n\nBLOCKSDK API는 블록체인 노드 서버 없이 즉시 개발을 시작할수 있는 API로써 이더리움,클레이튼,바이낸스 스마트 체인, 폴리곤, 아발란체,이더리움 클래식 등 6개이상의 블록체인을 지원하여 API를 사용하여 다양한 블록체인 네트워크를 통합적으로 거래소,NFT 마켓,NFT 민팅,DEX 등 다양한 블록체인 서비스 개발에 활용 하실수 있으며,개발을 빠르게 시작하기 위한 다양한 프로그래밍언어로 구성된 SDK 라이브러리도 지원해드리고 있습니다.\n\nAPI 토큰은 아래 링크를 통해 무료로 발급 받으실수 있습니다.\n\n[API 토큰 발급받기](https://blocksdk.com/ko/register)\n\n---\n\n# 빠른 시작 가이드\n\nBLOCKSDK API 으로 개발을 시작하려는 개발자를 위해 시작하는 몇 가지 간단한 단계가 있습니다.\n\n1.BLOCKSDK 회원가입을 하십시오.가입은 무료로 진행하실수 있습니다.\n\n2.로그인 또는 가입을 하신후 대시보드에 \\`API 토큰\\` 패널의 상자에서 API토큰을 복사합니다.\n\n3.아래 제공된 코드 예제를 사용하여 복사한 API 토큰을 사용하여 API를 호출하실수 있습니다.\n\n4.서비스를 개발및 구현 해보세요.이제 API가 잘 작동하는지 확인 했으므로 이 개발자문서의 나머지 부분을 읽고 서비스 개발을 시작해보세요!\n\n---\n\n# 인증\n\n---\n\n## API 키 획득\n\nBLOCKSDK API에 대한 모든 HTTP 요청은 API 토큰으로 검증되어야합니다. [BLOCKSDK](https://blocksdk.com/ko) 을 회원 가입을 하시면 무료로 API 토큰이 발급 됩니다.\n\n---\n\n## API 키 사용\n\nBLOCKSDK API를 대상으로 HTTP 요청을 할 수 있는 모든 서버 측 프로그래밍 언어를 사용할 수 있습니다.\n\n테스트넷 요청 도메인 : `https://testnet-api.blocksdk.com`\n\n메인넷 요청 도메인 : `https://mainnet-api.blocksdk.com`\n\n무료 플랜은 테스트넷 API만 이용하실수 있으며 , 테스트넷 API는 API 플랜 무관하게 모든 API에 접근하실수 있습니다\n\n다음 두 가지 방법 중 하나로 REST API 호출에 API 토큰을 제공 할 수 있습니다.\n\n선호하는 방법 : 사용자 정의 헤더를 통해 `X-API-TOKEN`\n\n편리한 방법 : 쿼리 문자열 매개 변수를 통해 `api_token`\n\n보안 경고 : 공개 액세스로부터 API 키를 보호하는 것이 중요합니다.\n\n---\n\n---\n\n## API 사용횟수\n\nAPI 사용량은 성공적인 (HTTP 상태 200) 데이터 호출에 대해 1:1로 증가합니다.\n\n사용량이 최고사용량에 도달하였다면 플랜 업그레이드를 고려해보세요\n\n# 공통 엔드 포인트 & 규약\n\n이더리움 , 클레이튼 , 바이낸스 스마트 체인 , 폴리곤 , 아발란체 , 이더리움 클래식 체인의 최상위 엔드 포인트 종류는 아래 표와 같이 나뉩니다.\n\n| **엔드포인트 종류** | **엔드포인트 설명** |\n| --- | --- |\n| {chain-name}/info | 블록체인의 정보와 평균 가스비를 반환 하는 엔드 포인트 |\n| {chain-name}/address/\\* | 특정 주소에대한 정보를 반환하거나 , 거래에 사용되는 엔드 포인트 |\n| {chain-name}/transaction/\\* | 특정 트랜잭션 정보를 반환하거나 , 거래를 전송 하는 엔드 포인트 |\n| {chain-name}/token/\\* | ERC20 인터페이스를 표준으로한 토큰의 정보를 반환하거나 거래에 사용되는 엔드 포인트 |\n| {chain-name}/single-nft/\\* | ERC721 인터페이스를 표준으로한 NFT 정보를 반환하는 엔드 포인트 |\n| {chain-name}/multi-nft/\\* | ERC1155 인터페이스를 표준으로한 NFT 정보를 반환하는 엔드 포인트 |\n| {chain-name}/contract/\\* | 스마트 계약의 Function을 호출 하거나 , 실행 하는 엔드 포인트 |\n\n## 체인 이름 (chain-name)\n\n이 체인 이름은 엔드포인트에 포함 됩니다.\n\n이더리움 : eth\n\n클레이튼 : klay\n\n바이낸스 스마트 체인 : bsc\n\n폴리곤 : matic\n\n아발란체 (C-CHAIN) : avax\n\n이더리움 클래식 : etc\n\n---\n\n# 오류 및 속도 제한\n\n---\n\n## API 요청 제한\n\nBLOCKSDK API의 사용은 API 호출 속도 제한 또는 \"요청 제한\"의 적용을받습니다. HTTP 429 \"Too Many Requests\"조절 오류를 수신하기 전에 API 토큰을 사용하여 동시에 또는 같은 분 내에 수행 할 수있는 HTTP 호출 수입니다. 이 제한은 사용량 플랜에 따라 확장 되며 60초마다 재설정됩니다. 속도 제한과 잘 작동하는 구현 전략에 대한 모범 사례 를 검토하십시오 .\n\n---\n\n## HTTP 상태 코드\n\nAPI는 표준 HTTP 상태 코드를 사용하여 API 호출의 성공 또는 실패를 나타냅니다.\n\n\\* \\`400 (Bad Request)\\` 잘못된 인수로 인해 서버가 요청을 처리 할 수 ​​없습니다.  \n\\* \\`403 (Forbidden)\\`API 키의 관련 서비스 계획에 대한 제한과 같은 권한 문제로 인해 요청이 거부되었습니다.  \n\\* \\`429 (Too Many Requests)\\`API 키의 속도 제한을 초과했습니다. HTTP 요청 제한 오류 인 경우 API 요청 빈도를 낮추는 것이 좋습니다. 일별 API 호출 한도에 도달 한 경우 서비스 플랜을 업그레이드하는 것이 좋습니다.  \n\\* \\`500 (Internal Server Error)\\` 예기치 않은 서버 문제가 발생했습니다.\n\n---\n\n## 오류 응답 코드\n\n`status`객체는 항상 가능하면 모두 성공적으로 호출과 실패에 대한 JSON 응답 페이로드에 포함되어 있습니다. 오류 시나리오 중에 `status`개체의 `code`및 `error` 개체 의 `message`속성을 참조 할 수 있습니다 . 해당되는 경우 아래 API 오류 코드 중 하나가 반환됩니다. 그렇지 않으면 일반 오류 유형에 대한 HTTP 상태 코드가 반환됩니다\n\n| HTTP 상태 | 에러 코드 | 에러 메시지 |\n| --- | --- | --- |\n| 401 | 1001 \\[API_KEY_INVALID\\] | 이 API키는 유효하지 않습니다. |\n| 401 | 1002 \\[API_KEY_MISSING\\] | API 키가 없습니다 |\n| 403 | 1004 \\[API_KEY_DISABLED\\] | 사용중단된 API키 입니다. |\n| 429 | 1005 \\[API_KEY_PLAN_MINUTE_RATE_LIMIT_REACHED\\] | API키의 HTTP 요청 속도 제한을 초과했습니다. 속도제한은 1분마다 재설정 됩니다. |\n| 429 | 1006 \\[API_KEY_PLAN_DAILY_RATE_LIMIT_REACHED\\] | API키의 일일 비율 한도를 초과했습니다. |\n\n# NODE RPC API 엔드포인트\n\n메인넷 NODE RPC API는 베이직 플랜부터 호출 가능 하며\n\n분당 3000회 호출수까지 지원 됩니다.\n\n| 블록체인 | 체인 ID | URL |\n| --- | --- | --- |\n| 이더리움 메인넷 | 1 | [https://main-eth-rpc.blocksdk.com/YOU_API_TOKEN](https://main-eth-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 이더리움 테스트넷 | 5 | [https://test-eth-rpc.blocksdk.com/YOU_API_TOKEN](https://main-etc-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 바이낸스 스마트 체인 메인넷 | 56 | [https://main-bsc-rpc.blocksdk.com/YOU_API_TOKEN](https://main-bsc-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 바이낸스 스마트 체인 테스트넷 | 97 | [https://test-bsc-rpc.blocksdk.com/YOU_API_TOKEN](https://test-bsc-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 폴리곤 메인넷 | 137 | [https://main-matic-rpc.blocksdk.com/YOU_API_TOKEN](https://main-matic-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 폴리곤 테스트넷 | 80001 | [https://test-matic-rpc.blocksdk.com/YOU_API_TOKEN](https://test-matic-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 클레이튼 메인넷 | 8217 | [https://main-klay-rpc.blocksdk.com/YOU_API_TOKEN](https://main-klay-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 클레이튼 테스트넷 | 1001 | [https://test-klay-rpc.blocksdk.com/YOU_API_TOKEN](https://test-klay-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 아발란체 X체인 메인넷 | 43114 | [https://main-avax-rpc.blocksdk.com/YOU_API_TOKEN](https://main-avax-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 아발란체 X체인 테스트넷 | 43113 | [https://test-avax-rpc.blocksdk.com/YOU_API_TOKEN](https://test-avax-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 이더리움 클래식 메인넷 | 61 | [https://main-etc-rpc.blocksdk.com/YOU_API_TOKEN](https://main-etc-rpc.blocksdk.com/YOU_API_TOKEN) |\n| 이더리움 클래식 테스트넷 | 6 | [https://test-etc-rpc.blocksdk.com/YOU_API_TOKEN](https://test-etc-rpc.blocksdk.com/YOU_API_TOKEN) |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"20292093","team":3392106,"collectionId":"c79d11a0-f6ec-4f84-b7e6-3b7b21e73d56","publishedId":"Uz5FKwxw","public":true,"publicUrl":"https://documenter-api.postman.tech/view/20292093/Uz5FKwxw","privateUrl":"https://go.postman.co/documentation/20292093-c79d11a0-f6ec-4f84-b7e6-3b7b21e73d56","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"1e5fe3"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2022-06-02T11:23:03.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/06381bc7b819a99cee8656c9a71da678b1eb7c31586c643ed68b23577e6522fe","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/Uz5FKwxw"}