> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced Trade Scope & Permissions

> Per-endpoint OAuth and API key scopes for Advanced Trade REST.

A CDP API key needs `view`, `trade`, or `transfer`. An OAuth token needs the OAuth scope listed for that endpoint. Public methods need neither. On Global Derivatives, `public/auth` takes a CDP JWT (or OAuth token) in the request to mint the access token — it does not need a key scope.

<Tabs>
  <Tab title="Spot and US Derivatives">
    | Endpoint                                         | OAuth 2.0 Scope                                    | API Key Scope |
    | :----------------------------------------------- | :------------------------------------------------- | :------------ |
    | GET /accounts                                    | `wallet:accounts:read`                             | `view`        |
    | GET /accounts/\{account\_uuid}                   | `wallet:accounts:read`                             | `view`        |
    | POST /orders                                     | `wallet:buys:create`                               | `trade`       |
    | POST /orders/batch\_cancel                       | `wallet:buys:create`                               | `trade`       |
    | POST /orders/edit                                | `wallet:buys:create`                               | `trade`       |
    | POST /orders/edit\_preview                       | `wallet:buys:create`                               | `view`        |
    | POST /orders/close\_position                     | `wallet:buys:create` or `wallet:transactions:read` | `trade`       |
    | GET /orders/historical/batch                     | `wallet:transactions:read`                         | `view`        |
    | GET /orders/historical/fills                     | `wallet:transactions:read`                         | `view`        |
    | GET /orders/historical/\{order\_id}              | `wallet:transactions:read`                         | `view`        |
    | POST /orders/preview                             | `wallet:buys:create`                               | `view`        |
    | GET /best\_bid\_ask                              | `wallet:user:read`                                 | `view`        |
    | GET /product\_book                               | `wallet:user:read`                                 | `view`        |
    | GET /products                                    | `wallet:user:read`                                 | `view`        |
    | GET /products/\{product\_id}                     | `wallet:user:read`                                 | `view`        |
    | GET /products/\{product\_id}/candles             | `wallet:user:read`                                 | `view`        |
    | GET /products/\{product\_id}/ticker              | `wallet:user:read`                                 | `view`        |
    | GET /transaction\_summary                        | `wallet:transactions:read`                         | `view`        |
    | POST /convert/quote                              | `wallet:trades:create`                             | `trade`       |
    | POST /convert/trade/\{trade\_id}                 | `wallet:trades:create`                             | `trade`       |
    | GET /convert/trade/\{trade\_id}                  | `wallet:trades:read`                               | `view`        |
    | GET /portfolios                                  | `wallet:accounts:read`                             | `view`        |
    | POST /portfolios                                 | `wallet:user:update`                               | `trade`       |
    | POST /portfolios/move\_funds                     | `wallet:transactions:transfer`                     | `transfer`    |
    | GET /portfolios/\{portfolio\_uuid}               | `wallet:accounts:read`                             | `view`        |
    | DELETE /portfolios/\{portfolio\_uuid}            | `wallet:accounts:read`                             | `trade`       |
    | PUT /portfolios/\{portfolio\_uuid}               | `wallet:user:update`                               | `trade`       |
    | GET /cfm/balance\_summary                        | `wallet:transactions:read`                         | `view`        |
    | GET /cfm/positions                               | `wallet:transactions:read`                         | `view`        |
    | GET /cfm/positions/\{product\_id}                | `wallet:transactions:read`                         | `view`        |
    | POST /cfm/sweeps/schedule                        | `wallet:transactions:transfer`                     | `transfer`    |
    | GET /cfm/sweeps                                  | `wallet:transactions:read`                         | `view`        |
    | DELETE /cfm/sweeps                               | `wallet:transactions:transfer`                     | `transfer`    |
    | GET /cfm/intraday/margin\_setting                | `wallet:user:read`                                 | `view`        |
    | POST /cfm/intraday/margin\_setting               | `wallet:user:update`                               | `trade`       |
    | GET /cfm/intraday/current\_margin\_window        | `wallet:user:read`                                 | `view`        |
    | GET /payment\_methods                            | `wallet:payment-methods:read`                      | `view`        |
    | GET /payment\_methods/\{payment\_method\_id}     | `wallet:payment-methods:read`                      | `view`        |
    | GET /key\_permissions                            | —                                                  | `view`        |
    | GET /intx/portfolio/\{portfolio\_uuid}           | `wallet:transactions:read`                         | `view`        |
    | GET /intx/positions/\{portfolio\_uuid}           | `wallet:transactions:read`                         | `view`        |
    | GET /intx/positions/\{portfolio\_uuid}/\{symbol} | `wallet:transactions:read`                         | `view`        |
    | GET /intx/balances/\{portfolio\_uuid}            | `wallet:transactions:read`                         | `view`        |
    | POST /intx/multi\_asset\_collateral              | `wallet:buys:create`                               | `trade`       |
    | POST /intx/allocate                              | `wallet:transactions:transfer`                     | `transfer`    |
  </Tab>

  <Tab title="Global Derivatives">
    | Endpoint                                             | OAuth 2.0 Scope            | API Key Scope |
    | :--------------------------------------------------- | :------------------------- | :------------ |
    | private/buy                                          | `wallet:buys:create`       | `trade`       |
    | private/sell                                         | `wallet:buys:create`       | `trade`       |
    | private/edit                                         | `wallet:buys:create`       | `trade`       |
    | private/edit\_by\_label                              | `wallet:buys:create`       | `trade`       |
    | private/cancel                                       | `wallet:buys:create`       | `trade`       |
    | private/cancel\_by\_label                            | `wallet:buys:create`       | `trade`       |
    | private/cancel\_all                                  | `wallet:buys:create`       | `trade`       |
    | private/cancel\_all\_by\_currency                    | `wallet:buys:create`       | `trade`       |
    | private/cancel\_all\_by\_currency\_pair              | `wallet:buys:create`       | `trade`       |
    | private/cancel\_all\_by\_instrument                  | `wallet:buys:create`       | `trade`       |
    | private/cancel\_all\_by\_kind\_or\_type              | `wallet:buys:create`       | `trade`       |
    | private/close\_position                              | `wallet:buys:create`       | `trade`       |
    | private/get\_open\_orders                            | `wallet:transactions:read` | `view`        |
    | private/get\_open\_orders\_by\_currency              | `wallet:transactions:read` | `view`        |
    | private/get\_open\_orders\_by\_instrument            | `wallet:transactions:read` | `view`        |
    | private/get\_open\_orders\_by\_label                 | `wallet:transactions:read` | `view`        |
    | private/get\_order\_state                            | `wallet:transactions:read` | `view`        |
    | private/get\_order\_state\_by\_label                 | `wallet:transactions:read` | `view`        |
    | private/get\_order\_history\_by\_currency            | `wallet:transactions:read` | `view`        |
    | private/get\_order\_history\_by\_instrument          | `wallet:transactions:read` | `view`        |
    | private/get\_order\_margin\_by\_ids                  | `wallet:transactions:read` | `view`        |
    | private/get\_trigger\_order\_history                 | `wallet:transactions:read` | `view`        |
    | private/get\_user\_trades\_by\_currency              | `wallet:transactions:read` | `view`        |
    | private/get\_user\_trades\_by\_currency\_and\_time   | `wallet:transactions:read` | `view`        |
    | private/get\_user\_trades\_by\_instrument            | `wallet:transactions:read` | `view`        |
    | private/get\_user\_trades\_by\_instrument\_and\_time | `wallet:transactions:read` | `view`        |
    | private/get\_user\_trades\_by\_order                 | `wallet:transactions:read` | `view`        |
    | private/get\_margins                                 | `wallet:accounts:read`     | `view`        |
    | private/get\_account\_summaries                      | `wallet:accounts:read`     | `view`        |
    | private/get\_account\_summary                        | `wallet:accounts:read`     | `view`        |
    | private/get\_position                                | `wallet:accounts:read`     | `view`        |
    | private/get\_positions                               | `wallet:accounts:read`     | `view`        |
    | private/change\_margin\_model                        | `wallet:user:update`       | `trade`       |
    | private/get\_access\_log                             | `wallet:user:read`         | `view`        |
    | private/get\_transaction\_log                        | `wallet:transactions:read` | `view`        |
    | private/get\_settlement\_history\_by\_currency       | `wallet:transactions:read` | `view`        |
    | private/get\_settlement\_history\_by\_instrument     | `wallet:transactions:read` | `view`        |
    | private/simulate\_portfolio                          | `wallet:accounts:read`     | `view`        |
    | private/pme/simulate                                 | `wallet:accounts:read`     | `view`        |
    | private/enable\_cancel\_on\_disconnect               | `wallet:buys:create`       | `trade`       |
    | private/disable\_cancel\_on\_disconnect              | `wallet:buys:create`       | `trade`       |
    | private/get\_cancel\_on\_disconnect                  | `wallet:user:read`         | `view`        |
    | private/create\_combo                                | `wallet:buys:create`       | `trade`       |
    | private/get\_leg\_prices                             | `wallet:user:read`         | `view`        |
    | private/create\_block\_rfq                           | `wallet:buys:create`       | `trade`       |
    | private/cancel\_block\_rfq                           | `wallet:buys:create`       | `trade`       |
    | private/accept\_block\_rfq                           | `wallet:buys:create`       | `trade`       |
    | private/cancel\_block\_rfq\_trigger                  | `wallet:buys:create`       | `trade`       |
    | private/get\_block\_rfqs                             | `wallet:transactions:read` | `view`        |
    | private/add\_block\_rfq\_quote                       | `wallet:buys:create`       | `trade`       |
    | private/edit\_block\_rfq\_quote                      | `wallet:buys:create`       | `trade`       |
    | private/cancel\_block\_rfq\_quote                    | `wallet:buys:create`       | `trade`       |
    | private/cancel\_all\_block\_rfq\_quotes              | `wallet:buys:create`       | `trade`       |
    | private/get\_block\_rfq\_quotes                      | `wallet:transactions:read` | `view`        |
    | private/get\_block\_rfq\_makers                      | `wallet:transactions:read` | `view`        |
    | private/get\_block\_rfq\_user\_info                  | `wallet:transactions:read` | `view`        |
    | private/execute\_block\_trade                        | `wallet:buys:create`       | `trade`       |
    | private/verify\_block\_trade                         | `wallet:buys:create`       | `trade`       |
    | private/approve\_block\_trade                        | `wallet:buys:create`       | `trade`       |
    | private/reject\_block\_trade                         | `wallet:buys:create`       | `trade`       |
    | private/simulate\_block\_trade                       | `wallet:transactions:read` | `view`        |
    | private/invalidate\_block\_trade\_signature          | `wallet:buys:create`       | `trade`       |
    | private/get\_block\_trade                            | `wallet:transactions:read` | `view`        |
    | private/get\_block\_trades                           | `wallet:transactions:read` | `view`        |
    | private/get\_block\_trade\_requests                  | `wallet:transactions:read` | `view`        |
    | private/get\_broker\_trades                          | `wallet:transactions:read` | `view`        |
    | private/get\_broker\_trade\_requests                 | `wallet:transactions:read` | `view`        |
  </Tab>
</Tabs>
