OAuth Resources
  • 🍇OAuth Resources
Powered by GitBook
On this page
  • Authorization
  • Base URL
  • Endpoints
  • Transaction History
  • Balances

OAuth Resources

Blockchain.com exposes two OAuth resource endpoints making custodial wallet data available.

Last updated 1 year ago

Authorization

Use the access token previously obtained via the oauth server. The access token should be included in resource endpoint requests as an authorization header containing a “”.

Base URL

Endpoints

Transaction History

  • Endpoint: /v1/transactions

  • Method: GET

  • Description: Retrieve the authenticated user's transaction history.

  • Parameters: startDate, endDate, type (optional)

  • Notes:

    • This endpoint can return a maximum of 30 days of history and by default will return the most recent 30 days of history.

    • Possible types include: withdrawal, deposit, trade

    • Possible statuses include: pending, complete, failed

  • Response:

    [
      {
        "id": "fde34db4-942b-4138-b407-5f04a2ddca92",
        "createdAt": "2024-04-05T13:14:57.957Z",
        "amount": 100.00,
        "currency": "USD",
        "type": "deposit",
        "status": "completed"
      },
      {
        "id": "df90726c-ceba-4024-8db8-753cbb2463f9",
        "createdAt": "2024-04-06T11:12:01.233Z",
        "amount": 1.2,
        "currency": "ETH",
        "type": "withdrawal",
        "status": "pending"
      },
      {
        "id": "11e99b2a-8c8f-42f4-b4ee-3bc1074963ae",
        "createdAt": "2024-04-08T09:01:01.114Z",
        "updatedAt": "2024-04-08T09:23:19.921Z",
        "inputAmount": 500.0,
        "inputCurrency": "USD",
        "outputAmount": 0.21222,
        "outputCurrency": "ETH",
        "type": "trade",
        "status": "complete"
      }
    ]
    

Balances

  • Endpoint: /v1/balances

  • Method: GET

  • Description: Retrieve an overview of the authenticated user's account, including asset details such as symbol, quantity, and current worth.

  • Response:

[
  {
    "symbol": "BTC",
    "isFiat": false,
    "quantity": 1.5,
    "currentWorth": 100422.90
  },
  {
    "symbol": "ETH",
    "isFiat": false,
    "quantity": 10,
    "currentWorth": 32205.60
  },
  {
    "symbol": "USD",
    "isFiat": true,
    "quantity": 309.92,
    "currentWorth": 309.92
  }
]

: read_transactions

: read_balance

🍇
Scope
Scope
bearer token
https://api.blockchain.info/partner-resource-gatewayapi.blockchain.info