{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Authorization","description":"The first provable exchange","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"authorization"},"children":["Authorization"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1.-create-an-api-key"},"children":["1. Create an API Key"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you login to your Hibachi Account from the UI, click on the gear button on the top right corner, then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Keys"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create API Key"]},", then follow the definition below to choose the correct setting for your API Key, and click on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generate"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select Account"]},": This is to choose the account you want to associate with this API Key. Note you cannot use an API Key you created to access another account you own."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name of the API Key"]},": a name you want to associate with this API Key"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Restrictions"]},": you can choose if this API Key will have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read-only"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read-write"]}," permissions.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT"]},", by default a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read-only"]}," permission is selected",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read-write"]}," permissions:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Trading"]},": This API Key will be place orders"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Withdraws"]},": This API Key will be able to withdraw funds from the exchange to outside destinations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transfers"]},": This API Key will be able to transfer funds to other sub-accounts related to the main account. This will not allow transferring to other users OR withdrawing unless the withdraw permission is present"]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the next page, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["save the API Key and Private Key to a safe vault"]}," (e.g. password manager etc).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE"]},": You will ONLY be able to see the Private Key during generation, so make sure you save it before exiting the page"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},", save below information that will be needed for API Endpoints interaction together with your API Key"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account ID"]},": you will see ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ID: XXX"]}," below your API Key Name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Public Key"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/guide_deposit_04.2cec36eca0b5490d05bc4c2a7a5f7196aedbfe14a781ec86edd3e1c8af226c9e.9c1bb791.png","alt":"Deposit Funds 4","title":"Deposit Funds 4"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2.-api-authorization"},"children":["2. API Authorization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In every API Request Header (except ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/market"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/ws/market"]},"), you supply the API Key with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--header 'Authorization: '"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3.-security-headers-in-request"},"children":["3. Security Headers in request"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User-Agent: None null value"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accept"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Content-Type"]}]}]},"headings":[{"value":"Authorization","id":"authorization","depth":1},{"value":"1. Create an API Key","id":"1.-create-an-api-key","depth":2},{"value":"2. API Authorization","id":"2.-api-authorization","depth":2},{"value":"3. Security Headers in request","id":"3.-security-headers-in-request","depth":2}],"frontmatter":{"seo":{"title":"Authorization"}},"lastModified":"2025-04-15T10:57:42.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api/authorization","userData":{"isAuthenticated":false,"teams":["anonymous"]}}