Negociação de opções (legado) REST

Acesso apenas de leitura aos dados de negociação de opções pré-atualização de um utilizador migrado — extrato histórico, contas legadas e estado de atualização da plataforma.

Visão Geral

Após a atualização da conta de um utilizador a partir da plataforma de opções legada, estes endpoints disponibilizam o extrato de transações pré-atualização e o mapeamento de contas para que o registo histórico permaneça acessível. Todos os três são apenas de leitura, requerem um token OAuth2 com o âmbito trade e estão limitados ao utilizador que efetua a chamada. Enquanto a migração de um utilizador ainda está pendente ou falhou, os endpoints de extrato e contas devolvem HTTP 409.

Fluxo de Trabalho Típico

1. Chame GET /trading/v1/options/legacy/migration-status para confirmar que a migração do utilizador atingiu o estado complete. Enquanto o estado for pending ou failed, os outros dois endpoints devolvem HTTP 409.
2. Liste os loginids e contas pré-atualização do utilizador através de GET /trading/v1/options/legacy/accounts.
3. Obtenha o histórico de transações pré-atualização por loginid através de GET /trading/v1/options/legacy/statement?loginid=..., paginando com limit e offset.
4. Para todas as operações de negociação ao vivo e gestão de contas, continue a utilizar os endpoints padrão de Options Trading — estas rotas legadas servem apenas dados históricos.

Endpoints Disponíveis

Autenticação

Todos os endpoints nesta secção requerem o cabeçalho Deriv-App-ID e um cabeçalho Authorization: Bearer YOUR_AUTH_TOKEN com o âmbito OAuth2 trade.

Âmbitos OAuth2

1curl -X GET "https://api.derivws.com/trading/v1/options/legacy/migration-status" \
2  -H "Deriv-App-ID: YOUR_APP_ID" \
3  -H "Authorization: Bearer YOUR_OAUTH_TOKEN"

Códigos de Estado da Resposta

São devolvidos códigos de estado HTTP padrão. Um 409 indica que a migração do utilizador está pendente ou falhou — isto é específico dos endpoints legados.

Formato de Resposta de Erro

Todas as respostas de erro seguem uma estrutura consistente com um array de erros e metadados:

1{
2  "errors": [
3    {
4      "status": 409,
5      "code": "MigrationPending",
6      "message": "User migration is pending or has failed"
7    }
8  ],
9  "meta": {
10    "endpoint": "/trading/v1/options/legacy/statement",
11    "method": "GET",
12    "timing": 21
13  }
14}